RFC 9457 - Détails de problème pour les API HTTP

Internet Engineering Task Force (IETF)
Request for Comments: 9457
Rend obsolète: RFC 7807
Catégorie: Standards Track

Auteurs:

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

Date: Juillet 2023

---

Résumé

Ce document définit un "détail de problème" (problem detail) pour transporter des détails lisibles par machine des erreurs dans le contenu de réponse HTTP afin d'éviter le besoin de définir de nouveaux formats de réponse d'erreur pour les API HTTP.

Ce document rend obsolète la RFC 7807.

---

Statut de ce mémo

Ceci est un document de Standards Track de l'Internet.

Ce document est un produit de l'Internet Engineering Task Force (IETF). Il représente le consensus de la communauté IETF. Il a reçu un examen public et a été approuvé pour publication par l'Internet Engineering Steering Group (IESG). De plus amples informations sur les normes Internet sont disponibles dans la section 2 de la RFC 7841.

Des informations sur le statut actuel de ce document, les errata et comment fournir des commentaires peuvent être obtenues à https://www.rfc-editor.org/info/rfc9457.

---

Avis de copyright

Copyright (c) 2023 IETF Trust et les personnes identifiées comme auteurs du document. Tous droits réservés.

Ce document est soumis au BCP 78 et aux dispositions légales de l'IETF Trust relatives aux documents IETF (https://trustee.ietf.org/license-info) en vigueur à la date de publication de ce document. Veuillez consulter attentivement ces documents car ils décrivent vos droits et restrictions concernant ce document. Les composants de code extraits de ce document doivent inclure le texte de la licence BSD révisée comme décrit dans la section 4.e des dispositions légales du Trust et sont fournis sans garantie comme décrit dans la licence BSD révisée.

---

Table des matières

• 1. Introduction
• 2. Requirements Language (Langage des exigences)
• 3. The Problem Details JSON Object (L'objet JSON de détails de problème)
  • 3.1 Members of a Problem Details Object (Membres d'un objet de détails de problème)
    • 3.1.1 "type"
    • 3.1.2 "status"
    • 3.1.3 "title"
    • 3.1.4 "detail"
    • 3.1.5 "instance"
  • 3.2 Extension Members (Membres d'extension)
• 4. Defining New Problem Types (Définition de nouveaux types de problèmes)
  • 4.1 Example (Exemple)
  • 4.2 Registered Problem Types (Types de problèmes enregistrés)
    • 4.2.1 about:blank
• 5. Security Considerations (Considérations de sécurité)
• 6. IANA Considerations (Considérations IANA)
• 7. References (Références)
  • 7.1 Normative References (Références normatives)
  • 7.2 Informative References (Références informatives)
• Appendix A. JSON Schema for HTTP Problems (Schéma JSON pour les problèmes HTTP)
• Appendix B. HTTP Problems and XML (Problèmes HTTP et XML)
• Appendix C. Using Problem Details with Other Formats (Utilisation des détails de problème avec d'autres formats)
• Appendix D. Changes from RFC 7807 (Changements par rapport à la RFC 7807)
• Acknowledgements (Remerciements)
• Authors' Addresses (Adresses des auteurs)

---

Ressources associées

• RFC officielle: RFC 9457 (TXT)
• DataTracker: RFC 9457
• Rend obsolète: RFC 7807