Fehler

Jeder API-Fehler wird in einem einheitlichen Format zurückgegeben. Verzweigen Sie Ihre Logik basierend auf error.code und niemals basierend auf der menschenlesbaren Nachricht.

{
  "error": {
    "type": "permission_error",
    "code": "insufficient_scope",
    "message": "Dieser Zugangsdatensatz verfügt nicht über den Scope batches:write.",
    "docs_url": "https://ai-glot.com/docs/api/errors#insufficient_scope"
  },
  "request_id": "req_example"
}

Statuscodes

Authentifizierungs- und Berechtigungsfehler

authentication_required

Es wurde kein Bearer-Token gesendet. Bitte fügen Sie den Authorization-Header hinzu.

invalid_api_key

Der Schlüssel ist fehlerhaft oder unbekannt. Überprüfen Sie, ob der gesamte Wert aig_live_… kopiert wurde.

api_key_expired

Der Schlüssel hat seine konfigurierte Laufzeit überschritten. Erstellen oder verwenden Sie einen Ersatzschlüssel.

api_key_revoked

Ein Administrator hat diesen Schlüssel widerrufen oder rotiert. Aktualisieren Sie die Integration mit einem aktiven Zugangsdatensatz.

insufficient_scope

Die Authentifizierung war erfolgreich, aber es fehlt der für diesen Vorgang erforderliche Scope.

feature_not_available

Der Workspace-Plan oder die aktuelle Plattformversion beinhaltet das angeforderte Feature nicht.

admin_required

Dieser Vorgang darf nur von einem Workspace-Administrator ausgeführt werden.

Fehler bei Anfragen

invalid_request

Die Anfrage kann nicht analysiert werden oder entspricht nicht dem Endpoint-Kontrakt.

unknown_field

Eine Eigenschaft des JSON-Bodys wird nicht erkannt. Korrigieren Sie die Schreibweise, anstatt die Validierung zu entfernen. Unbekannte Query-Parameter lösen diesen Fehler nicht aus; sie werden ignoriert, sodass ein falsch geschriebener Filter ein ungefiltertes 200-Ergebnis liefert.

invalid_parameter

Ein Parameter hat den falschen Typ, Bereich oder das falsche Format.

invalid_cursor

Der Pagination-Cursor ist ungültig. Verwenden Sie den next_cursor exakt so, wie er zurückgegeben wurde.

request_too_large

Der Request-Body überschreitet das harte Limit des Endpoints.

Ressourcen- und Zustandsfehler

batch_not_found

Keine sichtbare Übersetzung hat diese ID. Ressourcen in einem anderen Workspace geben absichtlich denselben Fehler zurück.

glossary_not_found

Für dieses Sprachpaar existiert kein Glossar.

resource_not_found

Die angeforderte Ressource oder Route existiert nicht.

glossary_already_exists

Für dieses Sprachpaar existiert bereits ein Glossar. Aktualisieren Sie dieses, anstatt ein neues zu erstellen.

result_not_ready

Die Übersetzung ist noch nicht abgeschlossen, daher kann noch kein Ergebnis heruntergeladen werden.

batch_not_editable

Der aktuelle Zustand der Übersetzung erlaubt die angeforderte administrative Änderung nicht.

Sprach- und Glossarfehler

language_not_supported

Der Tag liegt außerhalb des unterstützten Katalogs. Lesen Sie GET /v1/languages.

invalid_language_pair

Der Identifikator des Sprachpaars kann nicht in zwei unterstützte BCP-47-Tags aufgeteilt werden.

glossary_term_limit_reached

Die resultierende Anzahl an Begriffen würde das Limit des Workspace-Plans überschreiten. Die Aktualisierung erfolgt atomar; es wurde nichts geändert.

glossary_limit_reached

Der Workspace hat die maximal zulässige Anzahl an Glossaren für den aktuellen Plan erreicht.

invalid_glossary_terms

Ein oder mehrere Glossareinträge sind leer, unvollständig oder anderweitig ungültig.

Service-Fehler

rate_limited

Die Zugangsdaten haben ein Rate-Limit-Fenster überschritten. Warten Sie auf Retry-After und versuchen Sie es dann mit Jitter erneut.

internal_error

AI Glot ist unerwartet fehlgeschlagen. Versuchen Sie es mit Backoff erneut und behalten Sie die request_id bei.

service_unavailable

Ein erforderlicher Dienst ist vorübergehend nicht verfügbar. Versuchen Sie es mit Backoff erneut.