--- title: "Fehler" description: "Behandeln Sie AI Glot API-Fehler mithilfe stabiler Fehlercodes, Request-IDs, Anweisungen für erneute Versuche und detaillierten Erklärungen für jeden dokumentierten." canonical: "https://ai-glot.com/docs/de/api/errors" updated: "2026-08-12" --- # 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. ```json title="Beispiel eines Fehlers" { "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 | Status | Bedeutung | Vorgehensweise | | ------- | ---------------------------------------------------------- | ---------------------------------------------- | | 400 | Fehlerhafte Anfrage oder unbekanntes Feld | Anfrage korrigieren | | 401 | Zugangsdaten fehlen, ungültig, abgelaufen oder widerrufen | Ersetzen oder erneuern | | 403 | Authentifiziert, aber nicht berechtigt | Erforderlichen Scope oder Feature freischalten | | 404 | Ressource nicht vorhanden oder außerhalb dieses Workspaces | ID und Workspace prüfen | | 409 | Aktueller Zustand steht im Konflikt mit der Anfrage | Ressource lesen und dann entscheiden | | 413 | Request-Body zu groß | Kleineren Body senden | | 422 | Format korrekt, aber Wert ungültig | Benannten Wert korrigieren | | 429 | Rate Limit erreicht | Auf `Retry-After` warten | | 500/503 | AI Glot Fehler oder vorübergehend nicht verfügbar | Mit Backoff erneut versuchen | **Vor erneutem Versuch beheben** Die meisten Antworten mit 400, 401, 403, 404, 409, 413 und 422 erfordern eine Änderung der Zugangsdaten, des Identifikators, des Zustands oder der Anfrage. **Sicher erneut versuchen** Wiederholen Sie Anfragen mit 429 nach Ablauf von `Retry-After`; wiederholen Sie 500 und 503 mit exponentiellem Backoff und zufälligem Jitter. > **Note** > > Speichern Sie die `request_id` in Ihren Logs und Support-Nachrichten. Sie identifiziert die serverseitige Anfrage, ohne Ihren API-Schlüssel oder CSV-Inhalte offenzulegen. ## 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`](/docs/api/languages/list). ### 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.