Zum Hauptinhalt springen

RFC 7807 - Problemdetails für HTTP-APIs (Problem Details for HTTP APIs)

Status: Durch RFC 9457 obsolet gemacht

Autoren: M. Nottingham, E. Wilde
Veröffentlicht: März 2016

Hinweis​

Dieser RFC wurde durch RFC 9457 obsolet gemacht.

RFC 7807 definierte das ursprüngliche Format für „Problemdetails" (problem details) für HTTP-APIs. Es wurde durch RFC 9457 ersetzt, das Verbesserungen und Klarstellungen enthält und gleichzeitig Abwärtskompatibilität beibehält.

Was war RFC 7807?​

RFC 7807 führte ein standardisiertes JSON/XML-Format zur Beschreibung von Fehlern in HTTP-API-Antworten ein:

{
  "type": "https://example.com/probs/out-of-credit",
  "title": "You do not have enough credit.",
  "status": 403,
  "detail": "Your current balance is 30, but that costs 50.",
  "instance": "/account/12345/msgs/abc"
}

Migration zu RFC 9457​

Wenn Sie Problemdetails zum ersten Mal implementieren, verwenden Sie RFC 9457 anstelle von RFC 7807.

Für bestehende Implementierungen:

  • RFC 9457 ist abwärtskompatibel mit RFC 7807
  • Keine grundlegenden Änderungen im Basisformat
  • Siehe RFC 9457 Anhang D für spezifische Änderungen

Ressourcen​

Letztes Update am