REST API.

RESTは、リソースをURIで識別し、標準化した操作や状態表現を使ってシステムを連携させるアーキテクチャスタイルである。一般的なWeb APIではGET、POST、PUT、DELETEなどのHTTPメソッドが利用される。

ただし、HTTPでJSONを返すだけでRESTの制約をすべて満たすわけではない。公開するデータの意味、エラー表現、認証、バージョン管理など、使う側にとって予測可能な設計が重要になる。実務ではRESTfulという言葉の使い方にも幅がある。

APIのエラーがすべて同じコードで返れば、利用者は原因を特定できない。正常系だけでなく、失敗時の振る舞いを明確にすることが品質に直結する。