Docs/Fehlerbehandlung

Fehlerbehandlung

Alle API-Fehler folgen einem einheitlichen Format. So gehst du sauber damit um.

Markdown ansehen OpenAPI JSON

Format der Fehlerantwort

Wenn ein Fehler auftritt, gibt die API ein JSON-Objekt mit dieser Struktur zurück:

json
{
  "error": "Validation Error",
  "message": "The email field is required.",
  "status_code": 422
}

Fehlercodes

StatuscodeFehlerUrsache & Lösung
400 Bad Request Fehlerhaftes JSON oder fehlende Pflichtfelder. Prüfe deinen Request-Body.
401 Unauthorized Fehlender oder ungültiger API-Key. Prüfe deinen Authorization Header.
402 Payment Required Nicht genug Credits. Kauf weitere Credits oder warte, bis das Tageslimit zurückgesetzt wird.
422 Validation Error Das Format der E-Mail-Adresse ist ungültig. Prüfe den Wert, den du sendest.
429 Too Many Requests Rate Limit überschritten. Prüfe den Retry-After Header und warte.
500 Internal Server Error Bei uns ist etwas schiefgelaufen. Versuch es in ein paar Sekunden noch einmal. Kontaktiere den Support , wenn es weiterhin fehlschlägt.

401 Unauthorized

json
{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}

Lösung: Prüfe, ob dein Authorization Header korrekt formatiert ist als Bearer YOUR_API_KEY. Prüfe deinen Key im Dashboard.

422 Validation Error

json
{
  "error": "Validation Error",
  "message": "The email field must be a valid email address.",
  "status_code": 422
}

Lösung: Stell sicher, dass der E-Mail-Wert ein gültiges E-Mail-Format hat (z. B. user@example.com). Bereinige deine Eingabe vor dem Senden.

429 Too Many Requests

json
{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please slow down.",
  "status_code": 429,
  "retry_after": 15
}

Lösung: Warte die Anzahl Sekunden aus retry_after , bevor du es erneut versuchst. Siehe Rate Limits →

Checkliste zur Fehlersuche