Passa al contenuto principale

RFC 7807 - Dettagli del problema per le API HTTP (Problem Details for HTTP APIs)

Stato: Reso obsoleto dall'RFC 9457

Autori: M. Nottingham, E. Wilde
Pubblicato: Marzo 2016

Avviso​

Questo RFC è stato reso obsoleto dall'RFC 9457.

L'RFC 7807 definiva il formato originale dei "dettagli del problema" (problem details) per le API HTTP. È stato sostituito dall'RFC 9457, che include miglioramenti e chiarimenti mantenendo la retrocompatibilità.

Cos'era l'RFC 7807?​

L'RFC 7807 ha introdotto un formato JSON/XML standard per descrivere gli errori nelle risposte delle API HTTP:

{
  "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"
}

Migrazione all'RFC 9457​

Se si stanno implementando i dettagli del problema per la prima volta, utilizzare l'RFC 9457 invece dell'RFC 7807.

Per le implementazioni esistenti:

  • L'RFC 9457 è retrocompatibile con l'RFC 7807
  • Nessuna modifica sostanziale nel formato di base
  • Vedere RFC 9457 Appendice D per le modifiche specifiche

Risorse​

Ultimo aggiornamento il