REST API
(れすとえーぴーあい/RESTful API)
- 起点・背景(海外)
- 2000年
- 更新
- 2026-11-05
一言でいうと
REST(Representational State Transfer)の設計原則に沿って、URLで示したリソース(データなどの情報)をHTTPメソッドで扱うAPIです。実務では、HTTPで呼び出せるAPI全般をこの名前で呼ぶことがあり、設計原則をすべて満たすとは限りません。
面接では、URLの単位やエラーの返し方、互換性の保ち方について候補者が担った判断を確認します。
開発元と登場年
REST APIに単一の開発元はありません。土台となるRESTは、Roy Thomas Fieldingが2000年にカリフォルニア大学アーバイン校の博士論文で、分散ハイパーメディアシステム(Webのように文書やデータをリンクでつなぐ分散システム)のアーキテクチャスタイルとして体系化しました。最初の版は1994年10月から1995年8月にかけて作成されています。
RESTは、効率と信頼性、拡張性を備えた分散システムをもたらす設計上の制約の集まりを指します。現在は、HTTP API全般の呼び名として使われることもあります。
何を解決するために生まれたか
FieldingがRESTを開発した動機は、Webがどう機能すべきかを示すアーキテクチャのモデルを作ることでした。HTTPとURIの標準化の作業では、RESTがWebの振る舞いを記述する枠組みとして使われました。
手続きの呼び出しを単位にするRPC型のAPIと異なり、REST APIでは、標準の意味を持つ統一インターフェースを通じてリソースへ要求を送ります。このため、間を中継するコンポーネントも要求の内容を解釈できます。
REST APIでは、操作の性質に応じてHTTPメソッドを使い分けます。各要求には、理解に必要な情報をすべて含めます。応答にキャッシュの可否を示すと、やり取りの一部を省略できます。
どこで使われているか
Webサービスのバックエンドとフロントエンド間の通信、モバイルアプリとサーバー間の通信、社内のマイクロサービス間の通信、外部の企業に機能を提供する公開APIで使われています。
たとえば注文を/orders/123というURLで示し、GETで読み取ります。
人材市場の実情
同じ「REST APIの経験」でも、呼び出す側の実装、決まった仕様に沿ったサーバー側の実装、仕様の決定では経験の中身が異なります。求人票の「REST API」がRESTの制約をすべて満たすAPIを指すとは限らないため、担当した範囲と扱ったAPIの種類を確認する必要があります。
混同されやすい技術との違い
| 用語 | 指すもの | REST APIとの違い |
|---|---|---|
| API | システム同士が機能やデータをやり取りするための取り決めの総称 | 総称。REST APIはそのうち、RESTの設計原則に沿うもの |
| HTTP API | HTTPで呼び出すAPI全般 | RESTの制約をすべて満たすとは限らない。実務ではREST APIと呼ばれることがある |
| GraphQL | 取得するデータの形を呼び出す側が指定できる問い合わせ言語 | REST APIはリソースをURLで示す。GraphQLはデータをURLで識別せず、一般的な実装では単一のエンドポイントで要求を受け、呼び出す側が問い合わせで取得する項目を指定する |
| API設計 | システム間の取り決めを実装の前に設計する作業 | 作業を指す語。REST APIは、その作業で選ぶ形式のひとつ |
採用担当の見極めポイント
- 「REST APIの経験」が、呼び出す側の実装、決まった仕様に沿ったサーバー側の実装、仕様の決定のどれにあたるかを分けて確認します。質問の例は「GET、POST、PUTで表しにくい操作(注文の取り消しなど)を、どのURLとメソッドで設計しましたか」です。判断の理由を説明できる場合は、リソースの単位を設計してきたと考えられます
- エラーの返し方を確認します。質問の例は「HTTPステータスとエラーの応答の形式をどう統一し、呼び出す側が理由を判別できるようにしましたか」です。具体的に答えられる場合は、呼び出す側の実装まで踏まえて設計してきたと判断する材料になります
- 既存の利用者がいるAPIを変更した経験を確認します。質問の例は「バージョンを上げるかどうかを、どの変更を基準に判断しましたか」です。基準と利用者への告知の方法を説明できる場合は、公開後の運用まで担ってきたと判断する材料になります