GET /api/developer/v1/servers/{id}/backups
Backups auflisten
Alle Backups des Servers. Die Liste ist kurz und hat deshalb keinen Cursor: nextCursor ist immer null.
Rechte
- backups:read Backups lesen
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
| id | Pfad | string (uuid) | ja | Id des Servers. |
Antworten
OK
application/json
SchemaDevBackupPageDto
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| data | DevBackupDto[] | ja | |
| data[].id | string | ja | |
| data[].name | string | ja | |
| data[].bytes | integer (int64) | ja | |
| data[].isSuccessful | boolean | ja | |
| data[].isLocked | boolean | ja | |
| data[].createdAt | string (date-time) | ja | |
| data[].completedAt | string (date-time) | null | ja | |
| nextCursor | string | null | ja | |
| limit | integer (int32) | ja |
{
"data": [
{
"id": "string",
"name": "string",
"bytes": 0,
"isSuccessful": true,
"isLocked": true,
"createdAt": "2026-10-05T12:00:00Z",
"completedAt": "2026-10-05T12:00:00Z"
}
],
"nextCursor": "string",
"limit": 0
}Codebeispiele
curl "https://api.zenit-hosting.de/api/developer/v1/servers/<id>/backups" \ -H "Authorization: Bearer $ZENIT_TOKEN"
POST /api/developer/v1/servers/{id}/backups
Backup anlegen
Startet ein Backup im Hintergrund (202). Ein gesperrtes Backup (isLocked) löscht die automatische Rotation nicht.
Rechte
- backups:write Backups anlegen
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
| id | Pfad | string (uuid) | ja | Id des Servers. |
| Idempotency-Key | Header | string | nein | Empfohlen für jeden POST. 1 bis 128 sichtbare ASCII-Zeichen ohne Leerzeichen. Derselbe Schlüssel mit derselben Anfrage liefert innerhalb von 24 Stunden die gespeicherte Antwort (Header `Idempotency-Replayed: true`), mit einer anderen Anfrage 422, solange die erste läuft 409. |
Request-Body
application/json
SchemaDevCreateBackupRequest
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | null | nein | |
| isLocked | boolean | nein |
{
"name": "string",
"isLocked": true
}Antworten
Accepted
application/json
SchemaDevBackupDto
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | string | ja | |
| name | string | ja | |
| bytes | integer (int64) | ja | |
| isSuccessful | boolean | ja | |
| isLocked | boolean | ja | |
| createdAt | string (date-time) | ja | |
| completedAt | string (date-time) | null | ja |
{
"id": "string",
"name": "string",
"bytes": 0,
"isSuccessful": true,
"isLocked": true,
"createdAt": "2026-10-05T12:00:00Z",
"completedAt": "2026-10-05T12:00:00Z"
}Codebeispiele
curl -X POST "https://api.zenit-hosting.de/api/developer/v1/servers/<id>/backups" \
-H "Authorization: Bearer $ZENIT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"isLocked": true
}'Bereich Backups geladen, 2 Endpunkte.