Fehlerbehandlung

Unsere API verwendet standardmäßige HTTP-Antwortcodes, um Erfolg oder Misserfolg von Anfragen anzuzeigen. Hier sind die häufigsten Fehlercodes, auf die Sie stoßen könnten, und wie Sie damit umgehen.

HTTP-Statuscodes
200 OK

Die Anfrage war erfolgreich.

400 Bad Request

Die Anfrage war ungültig oder kann nicht bearbeitet werden.

401 Unauthorized

Die Authentifizierung ist fehlgeschlagen oder wurde nicht bereitgestellt.

403 Forbidden

Die Anfrage wurde verstanden, aber abgelehnt, oder der Zugriff ist nicht erlaubt.

404 Not Found

Die angeforderte Ressource konnte nicht gefunden werden.

429 Too Many Requests

Sie haben die Ratenbegrenzung überschritten.

500 Internal Server Error

Auf unserer Seite ist etwas schiefgelaufen.

Fehlerantwortformat
Alle Fehlerantworten folgen diesem Format:
{
  "error": "error_code",
  "message": "Human-readable error message",
  "details": {}
}
Häufige Fehlercodes

invalid_api_key: Der angegebene API-Schlüssel ist ungültig.

missing_api_key: Es wurde kein API-Schlüssel angegeben.

invalid_ip: Die angegebene IP-Adresse ist ungültig.

invalid_domain: Die angegebene Domain ist ungültig.

rate_limit_exceeded: Sie haben Ihre Ratenbegrenzung überschritten.

quota_exceeded: Sie haben Ihr monatliches Kontingent überschritten.

server_error: Ein interner Serverfehler ist aufgetreten.

Bewährte Praktiken zur Fehlerbehandlung

Statuscodes prüfen: Prüfen Sie immer den HTTP-Statuscode, bevor Sie die Antwort verarbeiten.

Ratenbegrenzungen handhaben: Implementieren Sie für 429-Fehler eine geeignete Backoff- und Wiederholungslogik.

Fehler protokollieren: Protokollieren Sie detaillierte Fehlerinformationen zur Fehlersuche.

Sanfte Degradierung: Halten Sie Fallback-Mechanismen bereit, wenn die API nicht verfügbar ist.