RFC 9457 - HTTP API の問題詳細

• ステータス: Proposed Standard
• 発行日: July 2023
• ストリーム: IETF
• 廃止: RFC7807
• エラッタ: エラッタなし

---

概要

この文書は, HTTP API の新しいエラー応答形式を定義する必要性を回避するために, HTTP 応答コンテンツにおけるエラーの機械可読な詳細を伝達する "問題詳細" (problem detail) を定義します。

この文書は RFC 7807 を廃止します。

---

このメモのステータス

これはインターネット標準化過程文書です。

この文書は Internet Engineering Task Force (IETF) の成果物です。これは IETF コミュニティの合意を表しています。公開レビューを受け, Internet Engineering Steering Group (IESG) による公開承認を得ています。インターネット標準に関する詳細情報は RFC 7841 のセクション 2 で入手できます。

この文書の現在のステータス, 正誤表, およびフィードバックの提供方法に関する情報は https://www.rfc-editor.org/info/rfc9457 から入手できます。

---

著作権表示

Copyright (c) 2023 IETF Trust および文書著者として特定された者。全著作権所有。

この文書は BCP 78 および IETF 文書に関する IETF Trust の法的規定 (https://trustee.ietf.org/license-info) の対象であり, この文書の発行日に有効です。これらの文書をよく確認してください。これらはこの文書に関するあなたの権利と制限を説明しています。この文書から抽出されたコードコンポーネントは, Trust Legal Provisions のセクション 4.e に記載されている Revised BSD License テキストを含まなければならず (MUST), Revised BSD License に記載されているとおり保証なしで提供されます。

---

目次

• 1. Introduction (はじめに)
• 2. Requirements Language (要求事項の表記)
• 3. The Problem Details JSON Object (問題詳細 JSON オブジェクト)
  • 3.1 Members of a Problem Details Object (問題詳細オブジェクトのメンバー)
    • 3.1.1 "type"
    • 3.1.2 "status"
    • 3.1.3 "title"
    • 3.1.4 "detail"
    • 3.1.5 "instance"
  • 3.2 Extension Members (拡張メンバー)
• 4. Defining New Problem Types (新しい問題タイプの定義)
  • 4.1 Example (例)
  • 4.2 Registered Problem Types (登録された問題タイプ)
    • 4.2.1 about:blank
• 5. Security Considerations (セキュリティに関する考慮事項)
• 6. IANA Considerations (IANA に関する考慮事項)
• 7. References (参考文献)
  • 7.1 Normative References (規範的参考文献)
  • 7.2 Informative References (参考情報)
• Appendix A. JSON Schema for HTTP Problems (HTTP 問題の JSON スキーマ)
• Appendix B. HTTP Problems and XML (HTTP 問題と XML)
• Appendix C. Using Problem Details with Other Formats (他の形式での問題詳細の使用)
• Appendix D. Changes from RFC 7807 (RFC 7807 からの変更)
• Acknowledgements (謝辞)
• Authors' Addresses (著者の連絡先)

---

関連リソース

• 公式 RFC: RFC 9457 (TXT)
• DataTracker: RFC 9457
• 廃止: RFC 7807