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

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.