Fehler

Antwortformat

Alle Fehler geben einen JSON-Körper zurück:

{
  "error": {
    "code": "validation_failed",
    "message": "Die angegebenen Daten waren ungültig.",
    "details": {
      "email": ["Die E-Mail wurde bereits vergeben."]
    }
  },
  "request_id": "req_01HXXXXXX"
}

Fügen Sie beim Kontakt mit dem Support immer die request_id ein.

HTTP-Statuscodes

Status	Bedeutung
200 OK	Erfolg
201 Created	Ressource erstellt
400 Bad Request	Fehlerhafte Anfrage
401 Unauthorized	Fehlendes oder ungültiges Token
403 Forbidden	Gültiges Token, aber unzureichende Berechtigungen
404 Not Found	Ressource nicht gefunden
409 Conflict	Konflikt (z. B. E-Mail bereits vergeben)
422 Unprocessable Entity	Validierung fehlgeschlagen
429 Too Many Requests	Rate-Limit überschritten
500 Internal Server Error	Serverseitiger Fehler

Fehlercodes

Code	Beschreibung
validation_failed	Anfragekörper hat die Validierung nicht bestanden
unauthorized	Token fehlt oder ist abgelaufen
forbidden	Token fehlt der erforderliche Berechtigungsbereich
not_found	Ressource existiert nicht
conflict	Eindeutigkeitsbeschränkung verletzt
rate_limited	Zu viele Anfragen
internal_error	Unerwarteter Serverfehler