Fehlercodes
Jede Fehlerantwort folgt RFC 9457 und trägt neben Statuscode und Titel ein Feld code aus dieser Liste sowie retryable. Wer auf Fehler reagiert, verzweigt auf code: der Text darf sich ändern, der Code nicht.
| Code | Status | Bedeutung | Wiederholen |
|---|---|---|---|
INVALID_PARAMS | 400 | Invalid request parameters | nein |
INVALID_ID | 400 | Invalid resource identifier | nein |
INVALID_CURSOR | 400 | Invalid or stale cursor | nein |
RESULT_WINDOW_EXCEEDED | 400 | Requested page lies beyond the maximum result window | nein |
MISSING_API_KEY | 401 | API key required | nein |
INVALID_API_KEY | 401 | Invalid or inactive API key | nein |
EXPIRED_API_KEY | 401 | API key has expired | nein |
INSUFFICIENT_SCOPE | 403 | API key is missing a required scope | nein |
MISSING_MODULE | 403 | Organization is missing a required module | nein |
IP_NOT_ALLOWED | 403 | Client IP is not in the key allowlist | nein |
NOT_FOUND | 404 | Resource not found | nein |
CONFLICT | 409 | Conflicting state | nein |
SYNC_TOKEN_EXPIRED | 410 | Sync token expired, start a full resync | nein |
URI_TOO_LONG | 414 | Request URI too long, use POST /v1/units/search | nein |
UNPROCESSABLE | 422 | Request is well-formed but semantically invalid | nein |
RATE_LIMIT_EXCEEDED | 429 | Rate limit exceeded | ja |
QUOTA_EXCEEDED | 429 | Monthly request quota exhausted | ja |
INTERNAL_ERROR | 500 | Internal server error | nein |
SERVICE_UNAVAILABLE | 503 | Service temporarily unavailable | ja |