Using the REST API, you can retrieve a company backup as follows:
GET /c/db_nazev/backup
if you include the
Acceptheader, its value must be application/x-winstrom-backup (or application/octet-stream).
You can also restore a company from a backup using the REST API:
PUT /c/db_nazev/restore?name=Firma
the
nameparameter is optional,the request body must contain the company backup,
if you include the
Content-Typeheader, its value must be application/x-winstrom-backup (or application/octet-stream).
Warning: the company being restored must not already exist — it will be created during the restore process. If the company already exists, the server will return the result Company 'restored_company' already exists. If you include an invalid character in the company identifier, you will be redirected to a URL with a valid identifier.
When restoring from a backup, it is also possible to mark the company as a test company and disable features that are not desirable during testing.
Restoring a test company
If you want to restore a company as a test company, you need to add the forTesting=1 parameter to the URL (e.g. PUT /c/db_nazev/restore?name=Firma&forTesting=1).
In this mode, you can additionally specify which features should be disabled. By default (when not specified), parameters have the value 1, which causes the corresponding feature to be disabled. If a feature should not be disabled, provide the parameter with the value 0.
Features that can be disabled:
| Disables sending messages to EET. In all validity periods of the company settings, the Communication mode property (on the Automatic operations — EET tab) will be changed to the value |
| Disables automatic email sending. In all validity periods of the company settings, the Automatically send documents by email property (on the Other tab) will be changed to the value |
| Unregisters all Web Hooks that are registered in the company. |
| Optional parameter — do not restore the change history |
| Optional parameter — do not restore the Changes API history |
The URL might then look like /c/db_nazev/restore?name=Firma&forTesting=1&disableAutoSendMail=0&skipZurnal