Behandeln Sie Fehler, ohne den Anfragekontext zu verlieren.
{
"text": "Komplexer Ausgangstext in der ausgewählten Sprache.",
"locale": "de",
"mode": "simple-language"
}SDK und cURL-Beispiele verfügbar
Fehlerumschlag
Der Produktionsfehlerumschlag der Version 2 enthält ein Fehlerobjekt mit stabilen Code- und Nachrichtenfeldern.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Das optionale Detailobjekt enthält maschinenlesbaren Kontext wie retryAfterSeconds.
HTTP-Antwortheader enthalten ggf. Authentifizierungs- und Wiederholungsmetadaten.
Erforderlicher Fehlerkatalog
Die folgenden Codes sind der aktuelle Version 2-Vertrag.
| HTTP | Code | Bedeutung | Kundenaktion |
|---|---|---|---|
| 400 | invalid_json | Der Anfragetext ist kein gültiges JSON | Korrigieren Sie den JSON-Body |
| 400 | invalid_request | Ein Feld fehlt, ist unbekannt oder ungültig oder der Text umfasst mehr als 10.000 Zeichen | Korrigieren Sie die Anfrage |
| 400 | invalid_idempotency_key | Ein Job oder eine Batch-Anfrage hat keinen gültigen Idempotency-Key | Senden Sie einen eindeutigen Schlüssel mit maximal 255 Zeichen |
| 400 | invalid_webhook_endpoint | Der ausgewählte Webhook-Endpunkt fehlt oder ist inaktiv | Wählen Sie einen aktiven Endpunkt oder verwenden Sie Polling |
| 401 | invalid_api_key | Das Bearer-Token fehlt, ist ungültig oder widerrufen | Überprüfen oder ersetzen Sie den API-Schlüssel |
| 402 | billing_required | Die Abrechnung muss aktualisiert werden, bevor die Verarbeitung fortgesetzt werden kann | Aktualisieren Sie die Abrechnung in der Anwendung |
| 403 | Abonnement_erforderlich | Der Arbeitsbereich verfügt über keine aktive Berechtigung | Wählen Sie einen Plan oder wenden Sie sich an den Support |
| 403 | email_not_verified | Es wird keine E-Mail-Adresse des Besitzers oder Administrators bestätigt | Bestätigen Sie die E-Mail-Adresse eines berechtigten Kontos |
| 404 | job_not_found | Der Job existiert nicht, gehört zu einem anderen Arbeitsbereich oder ist abgelaufen | Beenden Sie die Umfrage und erstellen Sie bei Bedarf einen neuen Job |
| 404 | batch_not_found | Der Stapel existiert nicht, gehört zu einem anderen Arbeitsbereich oder ist abgelaufen | Stoppen Sie die Abfrage und erstellen Sie bei Bedarf einen neuen Stapel |
| 429 | rate_limited | Die Anforderungsrate wurde erreicht | Respektieren Sie „Retry-After“. |
| 429 | Parallelitätslimit | Es werden zu viele Anfragen gleichzeitig bearbeitet | Versuchen Sie es erneut, nachdem eine aktive Anfrage abgeschlossen ist |
| 429 | Allowance_exhausted | Das monatliche Zeichenlimit ist erreicht und die zusätzliche Nutzung ist nicht verfügbar oder deaktiviert | Warten Sie auf den nächsten Abrechnungszeitraum oder aktivieren Sie die zusätzliche Nutzung für einen berechtigten Plan |
| 502 | processing_failed | Der Dienst konnte den Text nicht verarbeiten | Versuchen Sie es sicher noch einmal und kontaktieren Sie den Support mit der Anforderungs-ID, wenn das Problem weiterhin besteht |
Für jeden Fehler, Wiederholbarkeit des Dokuments, Abrechnungseffekt, Protokollsichtbarkeit und Supportinformationen.