Web、モバイルアプリ開発においてAPI設計は重要な要素である一方で経験をしないことにはなかなか自信を持って設計することが難しい。

ここで筆者が主張したいことはAPI設計は構造的に捉えることで設計をできるようになってほしいということである。

構造的に捉えることで、API設計の理解が深まり、設計の変更に対しても柔軟に対応できる。

ここからは設計のお題を提示し、構造的に捉えることで設計する練習をしていく。

お題

SNSアプリを作っていてコメントを投稿する機能と一覧表示する機能があるとする。

このとき、コメントを修正する機能を追加することになった。

以下の要求を満たすAPIを設計せよ。

このお題に対してどのようにするかを考えてみてください。

ここから下には筆者の考え方の一例を示す。

考え方

REST APIを考えるにおいて、HTTPの構造を理解しておくことが重要である。

HTTPはリクエストとレスポンスの構造になっている。

リクエストには

で構成される。

リクエスト行は

ヘッダー/ボディは各keyとvalueで構成される。

レスポンスには

で構成される。

ステータス行は

ヘッダー/ボディは各keyとvalueで構成される。

各要求に対してどこにどのような情報を持たせるかを考える。

ここから設計がどうなるかを書く。

レスポンスには正常系だけでなくエラー系も考える。

今回は簡単なお題と簡単な回答例を記載した。

構造的にHTTPを捉えてどの情報を何処に持たせるかを考えてAPI設計をすることで、柔軟に対応できるようになりましょう。