REST APIの意味

REST APIは、Representational State Transferの考え方に基づいて、ネットワーク上のリソースをHTTPなどで操作するAPIです。MDNはRESTを分散システム向けの設計スタイルとし、初心者向けには標準的なWebライブラリで呼び出せるHTTPサービスをREST APIと呼ぶことが多いと説明しています。一般的な設計では、リソースをURIで識別し、GETで取得、POSTで作成、PUTやPATCHで更新、DELETEで削除し、ステータスコードやJSONなどの表現で結果を返します。ただし、HTTP APIなら必ずRESTの全制約を満たすわけではありません。ステートレス性、キャッシュ、統一インターフェース、認証、冪等性、エラー形式、ページング、バージョン互換性などを個別に設計します。REST APIはGraphQLやgRPCと競合する場合がありますが、公開APIやブラウザー連携ではHTTPとJSONの扱いやすさが強みです。読み方は「レストエーピーアイ」です。

REST APIの背景には、ネットワーク上のリソースをURIで表し、HTTPなどの標準的な操作で扱うWebサービスの設計があります。MDNが説明する設計スタイルと、実務で広く使われる通称を区別します。