Fehler

Jeder API-Fehler verwendet dieselbe Struktur (Envelope). Verzweigen Sie im Code immer anhand von error.code, niemals anhand der menschenlesbaren Fehlermeldung.

{
  "error": {
    "type": "permission_error",
    "code": "insufficient_scope",
    "message": "This credential is missing the batches:write scope.",
    "docs_url": "https://ai-glot.com/docs/api/errors#insufficient_scope"
  },
  "request_id": "req_example"
}

Statuscodes

Authentifizierungs- und Berechtigungscodes

authentication_required

Es wurden keine Bearer-Zugangsdaten übermittelt. Fügen Sie den Authorization-Header hinzu.

invalid_api_key

Der Schlüssel ist fehlerhaft oder unbekannt. Prüfen Sie, ob der vollständige Wert aig_live_… kopiert wurde.

api_key_expired

Der Schlüssel hat sein konfiguriertes Ablaufdatum erreicht. Erstellen oder verwenden Sie einen Ersatz.

api_key_revoked

Ein Administrator hat diesen Schlüssel widerrufen oder rotiert. Aktualisieren Sie die Integration mit gültigen Zugangsdaten.

insufficient_scope

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

feature_not_available

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

admin_required

Nur ein Workspace-Administrator darf diesen Vorgang ausführen.

Request-Codes

invalid_request

Die Anfrage kann nicht geparst werden oder entspricht nicht dem Endpunkt-Vertrag.

unknown_field

Eine JSON-Body-Eigenschaft wird nicht erkannt. Korrigieren Sie die Schreibweise, anstatt die Validierung zu entfernen. Nicht erkannte Query-Parameter führen nie zu diesem Fehler; sie werden ignoriert, sodass ein falsch geschriebener Filter ein ungefiltertes 200 zurückgibt.

invalid_parameter

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

invalid_cursor

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

request_too_large

Der Request-Body überschreitet das feste Limit des Endpunkts.

Ressourcen- und Statuscodes

batch_not_found

Keine sichtbare Übersetzung besitzt 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 weiteres zu erstellen.

result_not_ready

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

batch_not_editable

Der aktuelle Status der Übersetzung lässt die angeforderte Verwaltungsänderung nicht zu.

Datei- und Formatcodes

unsupported_format

Die Dateiendung wird von AI Glot nicht akzeptiert. Siehe Dateien und Formate für die zwölf Familien und ihre Dateiendungen.

file_too_large

Die Datei überschreitet die Obergrenze für ihr Format. Die Limits gelten pro Format und nicht global (60 MB für CSV, 4 MB für einen PO-Katalog), sodass eine Größe, die für eine Dateiendung funktioniert, für eine andere abgelehnt werden kann.

file_fetch_failed

file_url konnte nicht abgerufen werden. Die URL muss HTTPS verwenden und das endgültige Ziel sein: Weiterleitungen wird nicht gefolgt, daher schlägt ein gekürzter oder signierter und dann weitergeleiteter Link hier fehl.

file_retention_expired

Die Aufbewahrungsfrist der hochgeladenen Datei ist abgelaufen und sie wird nicht mehr gespeichert. Erstellen Sie die Übersetzung erneut aus der Quelldatei.

file_expired

Die zugrunde liegende Datei dieser Übersetzung ist nicht mehr vorhanden, sodass der Vorgang nicht fortgesetzt werden kann.

result_too_large

Die fertige Übersetzung überschreitet die maximal rückgabefähige Größe. Teilen Sie die Quelldatei auf und übersetzen Sie sie in Teilen.

Plan- und Freigabecodes

plan_invalid

Die Anweisung oder Präzisierung konnte nicht in einen nutzbaren Plan umgewandelt werden. Formulieren Sie sie um: Die Angabe der zu übersetzenden Felder oder Spalten beim Namen ist zuverlässiger als deren Beschreibung.

no_plan_yet

Es wurde versucht, eine Freigabe zu erteilen, bevor ein Plan existierte. Rufen Sie zuerst POST /v1/batches/{batch_id}/plan auf; diese Absicherung verhindert, dass eine Integration einem Workspace Kosten für eine Übersetzung in Rechnung stellt, die niemand definiert hat.

batch_not_awaiting_approval

Die Übersetzung befindet sich nicht in einem Zustand, der freigegeben werden kann; in der Regel läuft sie bereits oder ist schon abgeschlossen. Rufen Sie per Polling GET /v1/batches/{batch_id} ab, anstatt die Freigabe erneut zu erteilen.

insufficient_credits

Das Guthaben des Workspaces reicht nicht aus, um die berechneten Kosten des Plans zu decken. Es wird nichts reserviert, sodass die Übersetzung weiterhin freigegeben werden kann, sobald Guthaben hinzugefügt wurde.

Sprach- und Glossarcodes

language_not_supported

Das Sprach-Tag gehört nicht zum unterstützten Katalog. Rufen Sie GET /v1/languages ab.

invalid_language_pair

Der Sprachpaar-Bezeichner kann nicht in zwei unterstützte BCP 47-Tags aufgeteilt werden.

glossary_term_limit_reached

Die resultierende Begriffsanzahl würde das Kontingent des Workspace-Plans überschreiten. Die Aktualisierung erfolgt atomar; es wurde nichts geändert.

glossary_limit_reached

Der Workspace hat die maximale 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-Codes

rate_limited

Die Zugangsdaten haben ein Ratenlimit-Fenster überschritten. Warten Sie auf Retry-After und wiederholen Sie die Anfrage anschließend mit Jitter.

internal_error

Bei AI Glot ist ein unerwarteter Fehler aufgetreten. Wiederholen Sie die Anfrage mit Backoff und bewahren Sie die request_id auf.

service_unavailable

Ein erforderlicher Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie die Anfrage mit Backoff.