Problem-Typen
Jede Fehlerantwort der API zeigt mit type auf eine dieser Seiten. Jede nennt Ursache, Ausweg und eine Beispielantwort.
Verzweige im Client auf code. Titel und Erklärung kommen in der Sprache deines Accept-Language, der Code bleibt gleich.
30 Problem-Typen
| Status | Code | Titel |
|---|---|---|
| 400 | INVALID_REQUEST | Ungültige Anfrage |
| 400 | BATCH_TOO_LARGE | Batch zu groß |
| 400 | CURSOR_MISMATCH | Cursor passt nicht zur Anfrage |
| 400 | UNKNOWN_PARAMETER | Unbekannter Parameter |
| 401 | UNAUTHENTICATED | Nicht authentifiziert |
| 403 | FORBIDDEN | Keine Berechtigung |
| 403 | RISK_FAMILY_BLOCKED | Risikofamilie gesperrt |
| 403 | ORGANIZATION_MISMATCH | Organisation passt nicht |
| 403 | API_MODULE_DISABLED | Öffentliche API nicht freigeschaltet |
| 404 | NOT_FOUND | Nicht gefunden |
| 404 | OPERATION_NOT_IN_VERSION | Operation in dieser Version nicht verfügbar |
| 409 | IDEMPOTENCY_IN_PROGRESS | Anfrage mit diesem Idempotency-Key läuft noch |
| 409 | UPLOAD_INCOMPLETE | Upload nicht abgeschlossen |
| 409 | WEBHOOK_ENDPOINT_LIMIT_REACHED | Zu viele Webhook-Endpunkte |
| 410 | VERSION_SUNSET | API-Version abgeschaltet |
| 412 | PRECONDITION_FAILED | Vorbedingung nicht erfüllt |
| 422 | VALIDATION_FAILED | Validierung fehlgeschlagen |
| 422 | IDEMPOTENCY_PAYLOAD_MISMATCH | Idempotency-Key mit anderem Inhalt |
| 422 | UPLOAD_CHECKSUM_MISMATCH | Prüfsumme des Uploads stimmt nicht |
| 422 | UPLOAD_REJECTED | Datei abgewiesen |
| 422 | BATCH_FAMILY_NOT_ALLOWED | Familie im Batch nicht erlaubt |
| 422 | WEBHOOK_URL_INVALID | Webhook-URL ungültig |
| 428 | PRECONDITION_REQUIRED | Vorbedingung erforderlich |
| 429 | RATE_LIMITED | Zu viele Anfragen |
| 429 | OVERLOADED | Instanz ausgelastet |
| 429 | QUOTA_EXHAUSTED | Kontingent erschöpft |
| 500 | INTERNAL | Interner Fehler |
| 502 | UPSTREAM | Fehler im nachgelagerten Dienst |
| 503 | API_PAUSED | API pausiert |
| 503 | INSTANCE_PENDING | Instanz wird aktualisiert |