REST
れすと
REST
一言でいうと
HTTPのメソッドとURLを使って、リソース指向で設計されたAPIスタイルのこと。
詳しい意味
REST（Representational State Transfer）は、Web上の「リソース（=データの塊）」を URL で識別し、HTTPメソッド（GET = 取得、POST = 作成、PUT/PATCH = 更新、DELETE = 削除）で操作するAPI設計スタイルです。「/users」「/users/123/orders」のように URL 自体が直感的にリソースを表すのが特徴。世の中のWeb APIの大半はREST準拠で、業界標準的存在。ステートレス（リクエスト毎に独立）・キャッシュフレンドリーが利点。ただし「複数リソースの一括取得」「必要な項目だけ取得」が苦手で、それを解決するのが GraphQL です。
何に使うか
Webサービスの基本的なAPI設計。フロントエンドとバックエンド間の通信。サードパーティに公開するAPI。
どんな時に出るか
「REST APIを設計」「REST準拠ですか？」「RESTfulに作る」といった場面で登場します。
具体例
- REST API を設計し、`/users` `/orders` `/products` といったリソース単位でエンドポイントを切った。
- REST と GraphQL を比較検討し、用途別に併用する構成にした。
別名・略称
rest(れすと)REST API(れすとえーぴーあい)RESTful(れすとふる)
間違えやすい語
初心者向けメモ
図書館の「本を借りる手続き」のような設計です。本（リソース）には住所（URL: /books/123）があり、借りる（GET）・返す（DELETE）・予約（POST）と動詞（HTTPメソッド）で操作する。誰でも同じルールで使えるから業界標準になっています。