Fehler
Die API verwendet Standard-HTTP-Statuscodes und RFC 7807 Problem Details für Fehlerantworten.
Fehlerformat #
Alle Fehlerantworten folgen dem RFC 7807 Problem Details-Format mit Content-Type: application/problem+json:
json
{
"status": 400,
"title": "Bad Request",
"detail": "The FirstName field is required."
}Statuscodes #
Die API verwendet die folgenden HTTP-Statuscodes:
| Status | Description |
|---|---|
| 200 OK | Anfrage erfolgreich |
| 201 Created | Ressource erfolgreich erstellt |
| 204 No Content | Anfrage erfolgreich, kein Inhalt zurückgegeben (z.B. Löschung) |
| 400 Bad Request | Ungültige Anfrage — fehlende oder ungültige Parameter |
| 401 Unauthorized | Authentifizierung fehlgeschlagen — fehlender oder ungültiger API-Schlüssel |
| 403 Forbidden | Verboten — der API-Schlüssel hat keine Berechtigung für diese Aktion |
| 404 Not Found | Ressource nicht gefunden |
| 409 Conflict | Konflikt — die Anfrage steht im Konflikt mit vorhandenen Daten |
| 429 Too Many Requests | Ratenlimit überschritten |
| 500 Internal Server Error | Interner Serverfehler |
Fehlerbeispiele #
Validierungsfehler (400)
json
{
"status": 400,
"title": "Bad Request",
"detail": "The FirstName field is required."
}Nicht gefunden (404)
json
{
"status": 404,
"title": "Not Found",
"detail": "Firefighter with ID '3fa85f64-5717-4562-b3fc-2c963f66afa6' was not found."
}Konflikt (409)
json
{
"status": 409,
"title": "Conflict",
"detail": "A firefighter with this email already exists."
}