DokumentationAPI Reference
Backups
Backups erstellen, wiederherstellen, löschen und Auto-Backup verwalten.
GET
/servers/:id/backupsAlle Backups des Servers auflisten.
curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/backups" \
-H "Authorization: Bearer rsk_your_key"Backup erstellen
POST
/servers/:id/backupsNeues Backup erstellen. Prüft Backup-Slot-Limit.
Body-Parameter
| Name | Type | Required | Description |
|---|---|---|---|
action | "create" | No | Standard wenn nicht angegeben |
name | string | No | Backup-Name |
locked | boolean | No | Backup vor Löschung schützen |
ignored | string[] | No | Dateien/Verzeichnisse ausschließen |
curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/backups" \
-H "Authorization: Bearer rsk_your_key" \
-H "Content-Type: application/json" \
-d '{ "name": "Before Update", "locked": true }'Backup wiederherstellen
Die manuelle Wiederherstellung ist für Budget- und Premium-Server verfügbar. Auto-Backup bleibt Premium oder dem Auto-Backup-Addon vorbehalten.
Body-Parameter
| Name | Type | Required | Description |
|---|---|---|---|
action | "restore" | Yes | |
backupId | string | Yes | Backup UUID |
truncate | boolean | No | Bestehende Dateien zuerst löschen |
curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/backups" \
-H "Authorization: Bearer rsk_your_key" \
-H "Content-Type: application/json" \
-d '{ "action": "restore", "backupId": "bkp_123", "truncate": true }'Backup löschen
Body-Parameter
| Name | Type | Required | Description |
|---|---|---|---|
action | "delete" | Yes | |
backupId | string | Yes | Backup UUID |
Sperre umschalten
Body-Parameter
| Name | Type | Required | Description |
|---|---|---|---|
action | "toggle_lock" | Yes | |
backupId | string | Yes | Backup UUID |
Download URL
Body-Parameter
| Name | Type | Required | Description |
|---|---|---|---|
action | "download_url" | Yes | |
backupId | string | Yes | Backup UUID |
Auto-Backup
Requires auto_backup (Premium oder Addon) or Premium plan
GET
/servers/:id/auto-backupAuto-Backup-Status abrufen.
POST
/servers/:id/auto-backupAuto-Backup aktivieren oder deaktivieren.
Body-Parameter
| Name | Type | Required | Description |
|---|---|---|---|
enabled | boolean | Yes | Auto-Backup ein/aus |
curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/auto-backup" \
-H "Authorization: Bearer rsk_your_key" \
-H "Content-Type: application/json" \
-d '{ "enabled": true }'Fehlercodes
| HTTP | Code | Beschreibung |
|---|---|---|
| 400 | LIMIT_EXCEEDED | Backup-Slot-Limit erreicht |
| 403 | ADDON_REQUIRED | Restore/Auto-Backup benötigt Addon oder Premium |
| 404 | SERVER_NOT_FOUND | Server nicht gefunden |