# Fehler, Paginierung & Idempotenz

> Statuscodes, Fehlerformat, Cursor-Paginierung und sichere Wiederholungen von Schreibanfragen.

Source: https://docs.avenlith.com/de/errors-and-pagination  
Category: API & Automatisierung  
Last updated: 2026-09-22

## 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:

```bash
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.

```bash
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"}'
```