REST とは何で、その主な制約は何ですか?

Question

IT Interview Practice · Accepted Answer

**REST** (Representational State Transfer) は、Roy Fielding によって定義されたネットワークアプリケーションの **アーキテクチャスタイル** です。プロトコルや標準ではなく — 従えば API をスケーラブルで、キャッシュ可能で、進化させやすくする **制約 (constraints)** の集合です。「RESTful」な API は、すべてを URI で識別される **リソース** (user、order、product) としてモデル化し、標準の HTTP メソッドで操作します。

## 中核的な制約

- **Client–server** — UI (client) をデータストレージ (server) から分離し、各々が独立に進化できるようにします。
- **Stateless** — すべてのリクエストが処理に必要なすべての情報を運びます。server はリクエスト間で **client のセッション状態を保持しません**。どの server もどのリクエストも扱えるため、水平スケーリングが容易です。
- **Cacheable** — レスポンスはキャッシュ可能かどうかを宣言し、client やプロキシが再利用できるようにします。
- **Uniform interface** — 決定的な制約: リソースは URI で識別され、表現 (通常 JSON) を介して操作され、メッセージは自己記述的で、ハイパーメディアリンクが client を導きます。
- **Layered system** — プロキシ、ゲートウェイ、ロードバランサが client と server の間に透過的に位置できます。
- **Code-on-demand** (オプション) — server は実行可能コード (例: JavaScript) を送れます。

## リソース指向のリクエスト

```http
GET /users/42 HTTP/1.1
Host: api.example.com
Accept: application/json
```

```http
HTTP/1.1 200 OK
Content-Type: application/json

{ "id": 42, "name": "Ann", "email": "ann@example.com" }
```

URI `/users/42` はリソースを名指し、`GET` はアクション、JSON は表現です。その組み合わせ — パスに名詞、HTTP メソッドに動詞 — が REST の核心です。

## なぜ重要なのか

REST は web API の支配的なスタイルなので、面接官はこの質問で、綴れるだけでなく *なぜ* 機能するかを理解しているか確認します。実際に最も重要な 2 つの制約は **statelessness** (各リクエストが自己完結するので、ロードバランサの背後に任意の数の server を置き、sticky session なしで水平スケールできる) と **uniform interface** (予測可能でリソース指向の URL に標準の HTTP メソッドと status code、つまり client はエンドポイントごとのカスタムロジックを必要としない) です。強い答えは制約を具体的な利点に結びつけます — statelessness がスケーリングを可能にし、cacheability が負荷を減らし、layered system が CDN やゲートウェイの挿入を許す — そして、ほとんどの「REST」API は完全に RESTful というより実用的である (HATEOAS を実装するものはほとんどない) と指摘します。これらの制約を理解することは、status code の選択から versioning まで、他のあらゆる REST 設計判断の基礎です。

中核的な制約

リソース指向のリクエスト

なぜ重要なのか

関連する質問