Fehlercodes
Fehler kommen als strukturiertes error-Objekt mit stabilem code; message kann sich ändern, code nicht.
Format
HTTP-Fehler antworten mit { "error": { "code": "…", "message": "…" } }. Fehlgeschlagene Analysen tragen den Code im Feld error.code des Analyse-Objekts (Status „—“ in der Tabelle).
Alle Codes
| Code | HTTP | Bedeutung |
|---|---|---|
| validation_error | 422 | Request-Body oder Parameter ungültig (Details in message). |
| unauthorized | 401 | API-Key fehlt, ist ungültig, widerrufen oder abgelaufen. |
| forbidden | 403 | Die Aktion ist für dieses Konto nicht erlaubt. |
| not_found | 404 | Ressource existiert nicht oder gehört zu einem anderen Konto. |
| insufficient_credits | 402 | Guthaben reicht nicht für die Reservierung — aufladen und erneut versuchen. |
| rate_limited | 429 | Mehr als 60 Requests/min — mit Backoff erneut versuchen. |
| too_many_jobs | 429 | Mehr als 5 gleichzeitig laufende Analysen — auf Abschluss warten. |
| document_too_large | 413 | Dokument größer als 100 MB. |
| too_many_pages | 422 | Dokument hat mehr als 300 Seiten. |
| invalid_document | 422 | Kein lesbares PDF (z. B. passwortgeschützt oder anderes Format). |
| unreadable | — | Analyse fehlgeschlagen: zu wenig erkennbarer Text (schlechter Scan). Keine Abbuchung. |
| upload_not_ready | 409 | Für den Upload wurde keine Datei hochgeladen oder er wurde bereits verwendet. |
| timeout | — | Analyse nach 30 Minuten abgebrochen. Keine Abbuchung. |
| internal_error | 500 | Unerwarteter Fehler — erneut versuchen, bei Häufung Support kontaktieren. |