REST APIとは何か？初心者向けにわかりやすく１分で解説

REST API（れすとえーぴーあい）はWebAPIの１つの形態です。WebAPIというのは、インターネットを通じてアクセス可能なAPI全般を指す用語ですが、その中でも特にREST（Representational State Transfer）というアーキテクチャスタイルに従ったAPIをREST APIと呼びます。

WebAPI
├── RestAPI ←今回解説する対象
├── SOAP
├── GraphQL
└── gRPC

参考　WebAPIとは？（APIとは？）

結論を超ザックリいえば、REST APIは「リソース」に対して「HTTPプロトコル」を使って「操作」する方法で、各リクエストが独立して処理されるAPIと言えます。

前提：APIとは何か？

API（エーピーアイ）は「Application Programming Interface」の略で、異なるソフトウェア同士が情報をやり取りするためのルールや仕組みを提供するものです。APIはその名の通りアプリケーションが他のアプリケーションの機能を使えるようにする「窓口」のような役割を果たします。

例えばスマートフォンの天気アプリは、気象データを提供するサービス（例えば、気象庁や気象会社）のAPIを使って最新の天気情報を取得します。（APIという「窓口」に知りたい気象情報を問い合わせ→回答を受け取ってくる。）このように、APIはアプリやサービスが他のアプリやサービスからデータを取得したり、機能を利用したりするために使われます。

REST APIとは

REST APIはWebAPIの１種。その中でも特に「REST」という設計原則に従ったAPIです。

WebAPI
├── RestAPI ←今回解説する対象
├── SOAP
├── GraphQL
└── gRPC

RESTは「Representational State Transfer」の略で、以下の４点が大きなポイントです。ザックリいえば、モノを「リソース」として扱い、そのリソースに対する操作を「HTTP」でリクエスト。これらのリクエストは単発で行われるということ。

ポイント	説明
リソース指向	データや機能をリソースとして扱い、それぞれに固有のURLが割り当てられる。
HTTPプロトコル	インターネット通信で使われる標準的なプロトコルを使用。
HTTPメソッド	データの操作をGET、POST、PUT、DELETEなどの標準的なHTTPメソッドで行う。
ステートレス	各リクエストは独立して処理され、サーバーはクライアントの状態を保持しない。

REST APIの特徴１：リソース指向

リソース指向とは、APIがデータや機能を具体的な「モノ」として扱う方法です。

図書館の本、これがリソースです。それぞれの本には固有の識別番号（例えばバーコード）があり、この番号を使って本を特定することができます。このときのバーコードがURLに当たります。このURLと後述する「HTTPメソッド」を組み合わせて、「村上春樹の本」を「Get（HTTPメソッド）」して！というような形でリクエストするイメージがリソース指向。

対してリソース指向ではないのは、図書館の利用者が特定の目的や手続きを実行するためにリクエストを行うようなイメージになります。この方式では本自体をリソースとして扱うのではなく、利用者の目的や手続きに基づいて操作が行われます。つまり「村上春樹の本を取得して！」というように、モノとそれに対する操作をひとくくりにしたもの（＝手続き・アクション）がリソース指向ではない例。

REST APIの特徴２：HTTPプロトコルを使用

REST APIは、HTTPプロトコルを使用します。

参考　HTTPとは？

HTTPプロトコルとは、簡単に説明すると「インターネットで情報をやり取りするためのルール」です。例えば私たちがWebサイトを見るとき、ブラウザはこのルールを使ってサーバーからページを取得し画面上にページ情報を表示します。REST APIも同じルールを使って、アプリやサービスがデータをやり取りするということです。

REST APIの特徴３：HTTPメソッドでリソースに対する処理を表す

HTTPメソッドは、インターネットでデータをやり取りする際に使用する特定の操作方法を指します。REST APIでは、主に4つのHTTPメソッド（GET、POST、PUT、DELETE）が使用され、これらを使って「リソース」の作成・取得・更新・削除を行います。

REST APIの特徴４：ステートレス

ステートレスとは、各リクエストが独立して処理され、サーバーがクライアントの状態を記憶しないことを指します。つまり、１つのリクエストが他のリクエストに依存しないということです。

参考　クライアントサーバシステムとは？

ファストフード店で食べ物を注文するとき、店員はあなたの過去の注文を覚えていません。あなたが来るたびに、注文を初めからやり直します。例えば、今日ハンバーガーを注文しても、明日また来たときに店員はそれを覚えていません。これは、各注文（リクエスト）が独立しているためです。

一方ステートフルの場合、昨日「ハンバーガーを1つください」と注文していたとしたら、今日来たときに「昨日と同じものをください」と言うだけで、店員は同じハンバーガーを出してくれます。また、今日は「追加でフライドポテトもください」と言えば、店員は昨日の注文にフライドポテトを追加します。