Welche HTTP-Statuscodes werden zurückgegeben?
Jeder Fehler enthält einen HTTP-Status und einen stabilen Fehlercode. Verzweigen Sie anhand des Codes, nicht anhand der Meldung.
Jede Fehlerantwort enthält einen Fehlercode und eine für Menschen geschriebene Meldung. Die Codes sind:
- 400 invalid_parameter: Ein Parameter ist unbekannt, fehlerhaft oder außerhalb des zulässigen Bereichs
- 400 invalid_cursor: Der Cursor ist fehlerhaft, abgelaufen oder wurde für einen anderen Schlüssel oder andere Filter ausgegeben
- 401 unauthenticated: Es wurde kein Schlüssel gesendet, oder er wird nicht erkannt oder wurde widerrufen
- 403 ip_not_allowed, key_paused, country_not_entitled oder upgrade_required: siehe „Warum erhalte ich einen 403-Fehler?“
- 404 not_found: Der Pfad existiert nicht
- 405 method_not_allowed: Jeder Endpunkt verwendet GET
- 429 rate_limited oder quota_exceeded: Warten Sie den Zeitraum aus Retry-After ab
- 500 internal_error: Versuchen Sie es später erneut
- 503 not_configured oder service_unavailable: Versuchen Sie es später erneut
Es können neue Codes hinzukommen. Behandeln Sie einen Code, den Sie nicht kennen, als Fehler des HTTP-Status, mit dem er eintrifft.