Fehler

Jeder API-Fehler verwendet denselben Antwortumschlag. Verzweigen Sie anhand von error.code, niemals anhand der menschenlesbaren Meldung.

{
  "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 wurde kein Bearer-Token ü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 festgelegtes Ablaufdatum erreicht. Erstellen Sie einen Ersatz oder verwenden Sie einen vorhandenen.

api_key_revoked

Ein Admin hat diesen Schlüssel widerrufen oder rotiert. Aktualisieren Sie die Integration mit aktiven Anmeldedaten.

insufficient_scope

Die Anmeldedaten wurden authentifiziert, verfügen aber nicht über den für diesen Vorgang erforderlichen Scope.

feature_not_available

Der Tarif des Arbeitsbereichs oder die aktuelle Plattformversion umfasst das angeforderte Feature nicht.

admin_required

Nur ein Admin des Arbeitsbereichs darf diesen Vorgang ausführen.

Anfragecodes

invalid_request

Die Anfrage lässt sich nicht parsen oder entspricht nicht dem Vertrag des Endpunkts.

unknown_field

Eine Eigenschaft im JSON-Body ist unbekannt. Korrigieren Sie die Schreibweise, statt die Validierung zu entfernen. Unbekannte Query-Parameter lösen diesen Fehler nicht aus, sondern werden ignoriert. Ein falsch geschriebener Filter liefert daher eine ungefilterte Antwort mit Status 200.

invalid_parameter

Ein Parameter hat den falschen Typ, liegt außerhalb des zulässigen Bereichs oder hat ein ungültiges Format.

invalid_cursor

Der Cursor für die Seitennavigation ist ungültig. Verwenden Sie next_cursor exakt so, wie er zurückgegeben wurde.

request_too_large

Der Anfrageinhalt überschreitet das feste Limit des Endpunkts.

Ressourcen- und Statuscodes

batch_not_found

Keine sichtbare Übersetzung hat diese ID. Ressourcen in einem anderen Arbeitsbereich lösen absichtlich denselben Fehler aus.

glossary_not_found

Für dieses Sprachenpaar ist kein Glossar vorhanden.

resource_not_found

Die angeforderte Ressource oder Route ist nicht vorhanden.

glossary_already_exists

Für dieses Sprachenpaar ist bereits ein Glossar vorhanden. Aktualisieren Sie es, statt 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 Dateierweiterung wird von AI Glot nicht unterstützt. Eine vollständige Liste der Formate und Erweiterungen finden Sie unter Dateien und Formate.

file_too_large

Die Datei überschreitet das Größenlimit ihres Formats. Die Limits gelten je Format, nicht allgemein (60 MB für CSV, 4 MB für einen PO-Katalog). Eine Dateigröße, die für eine Erweiterung zulässig ist, kann für eine andere abgelehnt werden.

file_fetch_failed

file_url konnte nicht abgerufen werden. Die URL muss HTTPS verwenden und direkt zum endgültigen Ziel führen. Weiterleitungen werden nicht verfolgt. Daher schlägt ein verkürzter Link oder ein signierter Link fehl, der anschließend weiterleitet.

file_retention_expired

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

file_expired

Die Datei, auf der diese Übersetzung basiert, ist nicht mehr verfügbar. Der Vorgang kann daher nicht fortgesetzt werden.

result_too_large

Die fertige Übersetzung überschreitet die maximal ausgebbare Größe. Teilen Sie die Quelldatei auf und übersetzen Sie die Teile einzeln.

Tarif- und Freigabecodes

plan_invalid

Die Anweisung oder Verfeinerung ließ sich nicht in einen verwendbaren Plan umwandeln. Formulieren Sie sie anders. Meist ist es zuverlässiger, die zu übersetzenden Felder oder Spalten konkret zu benennen.

no_plan_yet

Die Freigabe wurde angefordert, bevor ein Plan erstellt wurde. Rufen Sie zuerst POST /v1/batches/{batch_id}/plan auf. Diese Schutzmaßnahme verhindert, dass eine Integration einem Arbeitsbereich eine Übersetzung in Rechnung stellt, die niemand beschrieben hat.

batch_not_awaiting_approval

Die Übersetzung befindet sich nicht in einem Status, in dem eine Freigabe möglich ist. In der Regel läuft sie bereits oder ist schon abgeschlossen. Rufen Sie stattdessen regelmäßig GET /v1/batches/{batch_id} ab, statt erneut eine Freigabe zu erteilen.

insufficient_credits

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

Sprach- und Glossarcodes

language_not_supported

Das Sprach-Tag ist nicht im unterstützten Katalog enthalten. Rufen Sie GET /v1/languages ab.

invalid_language_pair

Die Kennung des Sprachenpaars lässt sich nicht in zwei unterstützte BCP 47-Tags aufteilen.

glossary_term_limit_reached

Die resultierende Anzahl an Begriffen würde das Kontingent des Tarifs für diesen Arbeitsbereich überschreiten. Die Aktualisierung erfolgt atomar. Es wurde nichts geändert.

glossary_limit_reached

Der Arbeitsbereich hat die für den aktuellen Tarif zulässige Anzahl an Glossaren erreicht.

invalid_glossary_terms

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

Servicecodes

rate_limited

Die Anmeldedaten haben das Zeitfenster für Anfragen überschritten. Warten Sie auf Retry-After und versuchen Sie es anschließend mit zufälligem Jitter erneut.

internal_error

Bei AI Glot ist ein unerwarteter Fehler aufgetreten. Versuchen Sie es mit Backoff erneut und bewahren Sie die request_id auf.

service_unavailable

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