API & Integration
Fehler 451 — Unavailable For Legal Reasons
Wann die API HTTP 451 zurückgibt, was das bedeutet und wie du den Fall in deiner Anwendung sauber behandelst.
Fehler 451 — Unavailable For Legal Reasons
Die Antwort HTTP 451 ist kein Bug, sondern eine absichtliche Compliance-Entscheidung: Für drei Bundesländer stehen aktuell keine amtlichen Daten zur Verfügung. Statt stille Falschwerte auszuliefern, antworten wir transparent.
Betroffene Bundesländer
- Bayern — Warteliste
- Schleswig-Holstein — Warteliste
- Sachsen — Warteliste
Beispiel-Response
HTTP/1.1 451 Unavailable For Legal Reasons
Content-Type: application/json
{
"error": "restricted_state",
"message": "Bayern stellt keine Bodenrichtwert-Daten bereit.",
"status": 451
}
Was tun?
In deiner App: fange den Status 451 explizit ab und zeige dem Nutzer einen hilfreichen
Hinweis — statt einer generischen Fehlermeldung. Die message nennt das betroffene
Bundesland; die Warteliste findest du unter /bundesland/<bundesland>.
const res = await fetch(url, { headers })
if (res.status === 451) {
const { message } = await res.json()
// User-Feedback: message + Link auf die Warteliste des Bundeslands
return null
}
Warum nicht einfach 404 oder 200 mit Null?
- 404 würde signalisieren, dass die Adresse nicht existiert — sie existiert aber.
- 200 mit null-Wert wäre gefährlich: Konsumenten könnten das als "kein Wert hinterlegt" interpretieren, statt als rechtlicher Block.
- 451 ist in RFC 7725 standardisiert und macht die Ursache eindeutig.