Fehler, Paginierung & Idempotenz
Statuscodes, Fehlerformat, Cursor-Paginierung und sichere Wiederholungen von Schreibanfragen.
Auf dieser Seite
Statuscodes#
| Code | Bedeutung |
|---|---|
| 200, 201 | Erfolg |
| 202 | Angenommen – die Aktion läuft asynchron |
| 400 | Ungültiger Body oder Parameter |
| 401 | Token fehlt oder ist ungültig |
| 403 | Dem Token fehlt die Berechtigung |
| 404 | Ressource nicht gefunden |
| 409 | Konflikt, z. B. Name bereits vergeben |
| 429 | Rate Limit überschritten – siehe Retry-After |
| 5xx | Serverfehler – Wiederholung mit Backoff ist sicher |
Fehlerformat#
JSON
{
"error": {
"code": "invalid_region",
"message": "Region 'ist2' does not exist.",
"request_id": "req_7Hn2kQ"
}
}
Geben Sie die request_id an, wenn Sie den Support kontaktieren.
Paginierung#
Listen-Endpunkte liefern bis zu 50 Einträge pro Seite (maximal 200). Nutzen Sie next_cursor aus meta für die nächste Seite:
Shell
curl "https://api.avenlith.com/v1/servers?per_page=50&cursor=eyJpZCI6InNydl84ZjJrMSJ9" \
-H "Authorization: Bearer $AVENLITH_TOKEN"
Idempotenz#
Senden Sie bei POST-Anfragen einen Idempotency-Key-Header. Eine Wiederholung mit demselben Schlüssel innerhalb von 24 Stunden liefert die ursprüngliche Antwort, statt einen doppelten Server anzulegen.
Shell
curl -X POST https://api.avenlith.com/v1/servers \
-H "Authorization: Bearer $AVENLITH_TOKEN" \
-H "Idempotency-Key: 5c1f7e8a-8a0b-4e8e-9d1b-1f0f7a2b9c11" \
-d '{"name": "web-01", "plan": "vps-pro", "region": "ist1"}'
War diese Seite hilfreich?
Noch Fragen?
Unsere Ingenieure beantworten Tickets rund um die Uhr — erste Antwort im Schnitt nach 7 Minuten.