Restore website backup available since version 4.0.0 / 3.7.316 On-Premises

Reference:

• Restore from backup file
• Restore from published website

Restores site backup from local file or remote URL.

Request JSON Object Properties:

• String domain - domain name used to identify web-site witch will be restored from backup (required).
• String file - absolute path inside builder server or absolute external URL to backup file to restore from (required).

On success you will get JSON encoded object as response. HTTP response code should be 200.

Response on Success JSON Object Properties:

• Boolean ok - it will be equal to true to indicate success.

Response on Error JSON Object Properties:

On error you will get JSON encoded object as response. HTTP response code should be something other than 200.

• Object error - error description object (only on error). Error object structure:
  • Number code - error code
  • String message - text describing the error

Request example:

POST /api/restore-site-backup HTTP/1.1
Host: 
Authorization: Basic W0FQSSBVc2VybmFtZSB3aWxsIGFwcGVhciBhZnRlciB5b3UgPGEgaHJlZj0iamF2YXNjcmlwdDp2b2lkKDApIiBjbGFzcz0iYnRuLWxvZ2luLXRyaWdnZXIiPmxvZyBpbjwvYT4gb3IgPGEgaHJlZj0iamF2YXNjcmlwdDp2b2lkKDApIiBjbGFzcz0iYnRuLXJlZ2lzdGVyLXRyaWdnZXIiPnNpZ24gdXA8L2E+XTpbQVBJIFBhc3N3b3JkIHdpbGwgYXBwZWFyIGFmdGVyIHlvdSA8YSBocmVmPSJqYXZhc2NyaXB0OnZvaWQoMCkiIGNsYXNzPSJidG4tbG9naW4tdHJpZ2dlciI+bG9nIGluPC9hPiBvciA8YSBocmVmPSJqYXZhc2NyaXB0OnZvaWQoMCkiIGNsYXNzPSJidG4tcmVnaXN0ZXItdHJpZ2dlciI+c2lnbiB1cDwvYT5d
Content-Type: application/json

{
    "domain": "site-to-restore.com",
    "file": "/mnt/backup_storage/site-to-restore.com_project.sitebuilder"
}

Response on success example:

HTTP/1.1 200 OK
Content-Type: application/json

{"ok": true}

Response on error example:

HTTP/1.1 500 Internal Error
Content-Type: application/json

{"error": {"code": 1, "message": "some kind of error message"}}

Every published website contains builder project files, which can be restored in the builder when needed. This is a 100% accurate restoration, which reverts the project that was in the builder at the time of the last publication.
In order to restore it to the builder, take the following steps:

1. locate the following 2 folders in the published website:
   • [public_html]/sitepro/dat
   • [public_html]/sitepro/gallery
   * where change [public_html] to the real path of the published website on hosting
2. locate the directory of that project in the builder:
   [builder]/data/e/x/example.com/
   * where change [builder] to the real path of your on-premises builder installation, change "example.com" to the website domain that needs to be restored, and change the part "/e/x/" to the 1st and 2nd symbols of the name of that domain
3. clear the builder project directory if it is not empty:
   rm -rf [builder]/data/e/x/example.com/*
4. copy 2 needed folders from the published website to the project directory in the builder
   * it can be done via SSH, FTP or other file manager that you prefer
5. if necessary, update permissions of copied folders with "chown":
   chown -R user:group [builder]/data/e/x/example.com
   * where change "user" and "group" to real user and group of your builder installation

After that, when opening the builder, the correct project should be loaded.