『Web API デザインの鉄則』第4章 エラー表現とドキュメント

第1章 第2章 第3章 Web APIのドキュメントに明示する必要がある項目としては、次のような事柄が挙げられます。 認可(Authorization)の方法、必要な権限(scope) エンドポイントURLやHTTPメソ …

『Web API デザインの鉄則』第3章 インタフェース設計

第1章 第2章 Web APIのインタフェースを定義する際に決めなければならない点は以下になります。 エンドポイントURI HTTPメソッド クエリパラメータ エンドポイントURIの定義 ROA(Resource Ori …

『Web API デザインの鉄則』第1章 読書メモ

第1特集の『Web API デザインの鉄則』が興味深い内容だったので、要約しておきます。 Web APIとは何か HTTPないしはHTTPSプロトコルによって通信が行われる 特定のHTTPメソッドを用いてアクセスできる …