Preskoči na glavno vsebino

Obnovenie zo zálohy

Obnovenie firmy zo zálohy v REST API

Avtor: Lenka Haringerová

Získanie zálohy

Pomocou REST API je možné získať zálohu firmy takto:

GET /c/db_nazev/backup
  • ak uvediete hlavičku Accept, musí nadobúdať hodnotu application/x-winstrom-backup (prípadne application/octet-stream),

  • odpoveď má Content-Type: application/x-winstrom-backup.

ℹ️ Pri inej hodnote hlavičky Accept (napr. application/json) server odpovie 406 Not Acceptable.


Obnovenie zo zálohy

Firmu je možné zo zálohy pomocou REST API aj obnoviť:

PUT /c/db_nazev/restore?name=Firma
  • parameter name je voliteľný — ak nie je uvedený, použije sa názov z posledného platného nastavenia firmy,

  • v tele požiadavky musí byť záloha firmy,

  • ak uvediete hlavičku Content-Type, musí nadobúdať hodnotu application/x-winstrom-backup (prípadne application/octet-stream) — inak server odpovie 415 Unsupported Media Type.

⚠️ Obnovovaná firma nesmie existovať, pri obnovení bude až založená. Ak firma už existuje, server odpovie 400 a hláškou Company 'db_nazev' already exists — v hláške je uvedený databázový identifikátor z URL, nie hodnota parametra name.

Ak uvediete v identifikátore firmy nepovolený znak, dôjde k presmerovaniu na URL s platným identifikátorom.


Obnovenie testovacej firmy

Pri obnovení zo zálohy je tiež možné firmu označiť ako testovaciu a vypnúť funkcie, ktoré nie sú pri testovaní žiaduce. Slúži na to parameter forTesting=1:

PUT /c/db_nazev/restore?name=Firma&forTesting=1

V tomto režime je navyše možné špecifikovať, ktoré funkcie majú byť vypnuté. Implicitne (pri neuvedení) majú parametre hodnotu 1, pri ktorej dochádza k vypnutiu zodpovedajúcej funkcie. Ak nemá dôjsť k vypnutiu, uveďte parameter s hodnotou 0.

Funkcie, ktoré je možné vypnúť:

disableEet

Dôjde k vypnutiu odosielania správ do EET. Vo všetkých platnostiach nastavenia firmy dôjde k zmene vlastnosti Mód komunikácie (na záložke Automatické operácie — EET) na hodnotu Vypnuto.

disableAutoSendMail

Vypne automatické odosielanie e-mailov. Vo všetkých platnostiach nastavenia firmy dôjde k zmene vlastnosti Automaticky odosielať doklady e-mailom (na záložke Ostatné) na hodnotu Neodesílat.

disableWebHooks

Odregistruje všetky Web Hooky, ktoré sú vo firme registrované.

skipZurnal

Voliteľný parameter — neobnoviť históriu zmien.

skipChangelog

Voliteľný parameter — neobnoviť históriu Changes API.

URL potom môže vyzerať napríklad takto:

PUT /c/db_nazev/restore?name=Firma&forTesting=1&disableAutoSendMail=0&skipZurnal


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?