HTTP-Fehler

Unsere API folgt einem vorhersehbaren HTTP-Fehlercode-Format:

  • 400 - invalid_request_error: Es gab ein Problem mit dem Format oder Inhalt Ihrer Anfrage. Wir können diesen Fehlertyp auch für andere 4XX-Statuscodes verwenden, die unten nicht aufgeführt sind.
  • 401 - authentication_error: Es gibt ein Problem mit Ihrem API-Schlüssel.
  • 403 - permission_error: Ihr API-Schlüssel hat keine Berechtigung, die angegebene Ressource zu nutzen.
  • 404 - not_found_error: Die angeforderte Ressource wurde nicht gefunden.
  • 413 - request_too_large: Die Anfrage überschreitet die maximal zulässige Anzahl von Bytes.
  • 429 - rate_limit_error: Ihr Konto hat ein Ratenlimit erreicht.
  • 500 - api_error: Ein unerwarteter Fehler ist in den internen Systemen von Anthropic aufgetreten.
  • 529 - overloaded_error: Die API von Anthropic ist vorübergehend überlastet.

Beim Empfang einer Streaming-Antwort über SSE ist es möglich, dass ein Fehler nach der Rückgabe einer 200-Antwort auftritt, wobei die Fehlerbehandlung nicht diesen Standardmechanismen folgen würde.

Fehlerstrukturen

Fehler werden immer als JSON zurückgegeben, mit einem error-Objekt auf oberster Ebene, das immer einen type und einen message-Wert enthält. Zum Beispiel:

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "The requested resource could not be found."
  }
}

Gemäß unserer Versionierungs-Richtlinie können wir die Werte innerhalb dieser Objekte erweitern, und es ist möglich, dass sich die type-Werte im Laufe der Zeit erweitern werden.

Anfrage-ID

Jede API-Antwort enthält einen eindeutigen request-id-Header. Dieser Header enthält einen Wert wie req_018EeWyXxfu5pfWkrYcMdjWG. Wenn Sie sich wegen einer bestimmten Anfrage an den Support wenden, geben Sie bitte diese ID an, damit wir Ihr Problem schnell lösen können.

Unsere offiziellen SDKs stellen diesen Wert als Eigenschaft auf Antwort-Objekten der obersten Ebene bereit, die den Wert des x-request-id-Headers enthält: