WebAPIの設計資料を追加する

[keitakn]

完了の定義

• 利用しやすいWebAPIを作成する為のノウハウが追加されている事

参考

• WebAPIでエラーをどう表現すべき？15のサービスを調査してみた

• WebAPI学習ソースまとめ

• 翻訳: WebAPI 設計のベストプラクティス

• Zalando RESTful API と イベントスキーマのガイドライン

• RFC7807 Problem Details for HTTP APIs

• https://www.eisbahn.jp/yoichiro/2017/01/rfc_7807.html

• 内部向けWeb APIでエラーレスポンスどう表現するか？

• RailsでHTTP APIのエラーレスポンスを "problem detail" 形式で返却する

[keitakn]

エラー時のレスポンスは RFC 7807 に従うのが良さそう。