Web API 設計の基本を学ぶ（APIエンドポイント） - Qiita

はじめに Web API の設計に関する基本的な考え方を理解するために、「Web API: The Good Parts」を読んでいます。 書籍の記述だけでは上手く腹落ちしなかった箇所で、追加で調べたことがタイトルに合致する内容であれば、こちらに追記していきます。 API エンドポイント（URI） の設計 Web API におけるエンドポイントは、API に アクセスするための URI を指します。 基本的には、URI が「リソース」を指すものであり、URI と HTTP メソッドの組み合わせで処理の内容を表すのが良い設計であるとされています。 これは、HTTP の URI がリソースを指すことで「名詞」として考え、それに HTTP メソッドを「動詞」として組み合わせることで、シンプルに行いたいことを表現することができるからです。 良い設計に近づけるために気をつけなければならないことを、い