剛剛在 Clubhouse 上聽到保哥提到了 RFC 7807 這個東西 (Problem Details for HTTP APIs),剛剛翻瀏覽器累積的 tab,發現原來先前有看到,而且有打算要出新版的消息:
RFC 7807 "Problem Details for HTTP APIs" has become a widely used standard for representing error messages. work has started on an updated version of the format. if you have any feedback about the spec, now would be a good time to make yourself heard. https://t.co/ERrsf1BbbN pic.twitter.com/dEQnzUMS3M
— Erik Wilde (@dret) January 29, 2021
RFC 7807 裡面這樣定義的方式可以讓 client 端直接判斷 Content-Type
知道這個回傳資料是不是錯誤訊息,不然以前都是 JSON 就得再另外包裝。用 Content-Type
的作法可以讓判斷條件變得清晰不少。
除了 application/problem+json
與 application/problem+xml
以外,在「3.1. Members of a Problem Details Object」裡面則是說明 JSON (或是 XML) 裡面有哪些必要以及可選的資訊要填,然後「3.2. Extension Members」這邊則大概描述一下怎麼擴充。
先有個印象,之後新規劃的東西可以考慮進去...
Mentions