RFC 9457 - Dettagli di problema per le API HTTP

Internet Engineering Task Force (IETF)
Request for Comments: 9457
Rende obsoleto: RFC 7807
Categoria: Standards Track

Autori:

• M. Nottingham
• E. Wilde
• S. Dalal

Data: Luglio 2023

---

Sommario

Questo documento definisce un "dettaglio di problema" (problem detail) per trasportare dettagli leggibili da macchina degli errori nel contenuto di risposta HTTP per evitare la necessità di definire nuovi formati di risposta di errore per le API HTTP.

Questo documento rende obsoleto RFC 7807.

---

Stato di questo documento

Questo è un documento Standards Track di Internet.

Questo documento è un prodotto dell'Internet Engineering Task Force (IETF). Rappresenta il consenso della comunità IETF. Ha ricevuto una revisione pubblica ed è stato approvato per la pubblicazione dall'Internet Engineering Steering Group (IESG). Ulteriori informazioni sugli Standard Internet sono disponibili nella sezione 2 di RFC 7841.

Le informazioni sullo stato corrente di questo documento, eventuali errata e come fornire feedback possono essere ottenute presso https://www.rfc-editor.org/info/rfc9457.

---

Avviso di copyright

Copyright (c) 2023 IETF Trust e le persone identificate come autori del documento. Tutti i diritti riservati.

Questo documento è soggetto a BCP 78 e alle disposizioni legali dell'IETF Trust relative ai documenti IETF (https://trustee.ietf.org/license-info) in vigore alla data di pubblicazione di questo documento. Si prega di esaminare attentamente questi documenti, in quanto descrivono i diritti e le restrizioni rispetto a questo documento. I componenti di codice estratti da questo documento devono includere il testo della licenza BSD rivista come descritto nella sezione 4.e delle disposizioni legali del Trust e sono forniti senza garanzia come descritto nella licenza BSD rivista.

---

Indice

• 1. Introduction (Introduzione)
• 2. Requirements Language (Linguaggio dei requisiti)
• 3. The Problem Details JSON Object (L'oggetto JSON dei dettagli di problema)
  • 3.1 Members of a Problem Details Object (Membri di un oggetto dettagli di problema)
    • 3.1.1 "type"
    • 3.1.2 "status"
    • 3.1.3 "title"
    • 3.1.4 "detail"
    • 3.1.5 "instance"
  • 3.2 Extension Members (Membri di estensione)
• 4. Defining New Problem Types (Definizione di nuovi tipi di problema)
  • 4.1 Example (Esempio)
  • 4.2 Registered Problem Types (Tipi di problema registrati)
    • 4.2.1 about:blank
• 5. Security Considerations (Considerazioni sulla sicurezza)
• 6. IANA Considerations (Considerazioni IANA)
• 7. References (Riferimenti)
  • 7.1 Normative References (Riferimenti normativi)
  • 7.2 Informative References (Riferimenti informativi)
• Appendix A. JSON Schema for HTTP Problems (Schema JSON per i problemi HTTP)
• Appendix B. HTTP Problems and XML (Problemi HTTP e XML)
• Appendix C. Using Problem Details with Other Formats (Uso dei dettagli di problema con altri formati)
• Appendix D. Changes from RFC 7807 (Modifiche rispetto a RFC 7807)
• Acknowledgements (Ringraziamenti)
• Authors' Addresses (Indirizzi degli autori)

---

Risorse correlate

• RFC ufficiale: RFC 9457 (TXT)
• DataTracker: RFC 9457
• Rende obsoleto: RFC 7807