HTTP-Fehler

Unsere API folgt einem vorhersehbaren Format für HTTP-Fehlercodes:

  • 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 verwenden.
  • 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 intern in den 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 auftreten kann, nachdem eine 200-Antwort zurückgegeben wurde. In diesem Fall würde die Fehlerbehandlung nicht diesen Standardmechanismen folgen.

Fehlerformen

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

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "Die angeforderte Ressource konnte nicht gefunden werden."
  }
}

In Übereinstimmung mit unserer Versionierungsrichtlinie können wir die Werte innerhalb dieser Objekte erweitern, und es ist möglich, dass die type-Werte im Laufe der Zeit wachsen 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.