這個案例的核心責任是提供錯誤格式標準化的現行基準(obsoletes RFC 7807)。

觀察

RFC 9457(IETF Proposed Standard、Standards Track、2023-07)定義 application/problem+json:五個核心成員 type(URI、預設 about:blank)、titlestatusdetailinstance;允許 extension members 且要求 client 忽略不認識的欄位;建立 IANA common problem types registry(7807 沒有)。RFC 明言 problem details 是補充 HTTP status code、不是取代。

判讀

type 用 URI 而非字串 enum、把錯誤種類的命名空間外部化、避免各團隊 code 撞名;「client MUST ignore unknown extensions」是向前相容的演化條款、等同錯誤模型的 OCP。registry 的新增是對 7807 生態碎片化的直接回應。

對應大綱

11.4 錯誤模型設計(anchor)、錯誤格式爭論文章。

下一步路由

模組十一案例庫

引用源