Fehler
Antwortformat
Alle Fehler geben einen JSON-Körper zurück:
{
"error": {
"code": "validation_failed",
"message": "The given data was invalid.",
"details": {
"email": ["The email has already been taken."]
}
},
"request_id": "req_01HXXXXXX"
}
Geben Sie beim Kontaktieren des Supports bei einem Fehler stets die request_id an.
HTTP-Statuscodes
| Status | Bedeutung |
|---|---|
200 OK | Erfolg |
201 Created | Ressource erstellt |
400 Bad Request | Fehlerhafte Anfrage |
401 Unauthorized | Fehlender oder ungültiger Token |
403 Forbidden | Gültiger 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 verfügt nicht über den erforderlichen Scope |
not_found | Ressource existiert nicht |
conflict | Verletzung einer Eindeutigkeitsbeschränkung |
rate_limited | Zu viele Anfragen |
internal_error | Unerwarteter Serverfehler |