Fehler

Wie Fehler aussehen

Jeder Fehler ist ein HTTP-Statuscode plus ein Körper nach RFC 9457 (application/problem+json). Kein Fehler kommt mit Status 200.

Aufbau

code ist der stabile, maschinenlesbare Name des Fehlers. detail ist ein Text für Menschen und kann sich jederzeit ändern.

Antwort

{
  "type": "https://mynextdays.com/entwickler/fehlercodes#fehler-zeitraum-nicht-verfuegbar",
  "title": "Konflikt",
  "status": 409,
  "detail": "Der Zeitraum ist belegt, gesperrt oder vom Verkauf ausgenommen. Es wurde keine Buchung angelegt.",
  "instance": "/v1/reservations",
  "code": "zeitraum_nicht_verfuegbar",
  "request_id": "3f1a9c7e4b2d48f0a1c5",
  "check_in": "2026-09-10",
  "check_out": "2026-09-13"
}

Feld	Bedeutung
type	Adresse der Beschreibung dieses Fehlertyps — die Liste der Fehlercodes im Anhang.
title	Kurzer Name des Fehlertyps.
status	Der HTTP-Statuscode.
detail	Beschreibung für Menschen.
code	Stabiler Name des Fehlers. Dieses Feld auswerten.
request_id	Kennung der Anfrage. Bei einer Support-Anfrage mitschicken.

Auf code verzweigen, nicht auf detail. Der Text ist keine Schnittstelle.

Statusklassen

4xx — die Anfrage ist das Problem: fehlendes Recht, unbekannte ID, ungültiger Wert, belegter Zeitraum. Ein Wiederholen ändert nichts.
5xx — serverseitiger Fehler. Wiederholen mit wachsendem Abstand.
429 — Ratenbegrenzung erreicht. Retry-After nennt die Wartezeit in Sekunden.

Nächste SeiteRatenbegrenzung