REST API

Representational State Transfer API

Web開発

Webの標準ルール（HTTPプロトコル）に沿って、URL経由でデータの取得や操作を行うシステム間の通信規約（API）のこと。リソース（データ）に対して、GETやPOSTなどのHTTPメソッドを使ってシンプルにやり取りを行います。

🐾 猫で例えると？

アメショと茶トラがお互いの腕と背中を枕にしてリソースをシェアして眠る様子 — お互いのリソースを上手に共有し合うWin-Winな連携

アメショが茶トラの腕を、茶トラがアメショの背中を枕にして、お互いの「リソース」を上手にシェアして寝ています。このように、独立したシステム同士がURLという共通の窓口を通じて、必要なデータや機能を無駄なくシンプルに共有し合うのがREST APIの仕組みです。

🐾 猫あるある：IT現場の日常

お腹を見せて撫でてとアピール：指定したエンドポイントへGETリクエストを送信し、必要なリソース（データ）を取得する通信処理。
空の皿を前に要求が通らないと悟る：存在しないURLへアクセスし、404 Not Foundのステータスコードを受け取って処理を中断する状態。
スリスリという決まったアピール：HTTPメソッドという共通ルールに従って要求を送り、サーバー側で意図した処理を実行させる仕組み。

💻 IT現場における「REST API」とは？

現在のWeb開発やスマートフォンアプリ開発において、システム同士を連携させるための最もスタンダードな手法です。フロントエンド（見た目）とバックエンド（データ処理）を完全に分離できるため、別々のチームが同時に開発を進めやすくなります。

「ユーザー情報を取得する」「新しい記事を投稿する」といった操作を、すべてHTTPの標準機能（GET、POST、PUT、DELETEなど）に割り当てて表現するため、新しく独自のルールを覚える必要がなく、非常に汎用性が高いのが特征です。

⚠️ REST APIの仕組みと注意点

REST APIを設計する際、URLは「動詞」ではなく「名詞」で構成するという重要な原則があります。例えば、ユーザー情報を取得する際に `/getUsers` というURLにするのは好ましくありません。正しくは `/users` というURLに対して、GETメソッドでアクセスする設計にします。

API通信での実装例

フロントエンドからバックエンドのREST APIを呼び出して、特定のデータを取得するシンプルな例です。

// JavaScript (Fetch API) でのREST APIリクエスト例
fetch('https://api.example.com/users/123') // ユーザーID:123のリソースを指定
  .then(response => {
    if (!response.ok) {
      throw new Error('データの取得に失敗しました');
    }
    return response.json(); // JSON形式のデータを抽出
  })
  .then(userData => {
    console.log('取得したユーザー情報:', userData);
  })
  .catch(error => console.error('エラー:', error));

このように、URLで「どのリソースか」を指し示し、HTTPメソッドで「何をしたいか」を伝えるだけのシンプルな構造が、開発現場で広く支持されている理由です。

🛠️ REST APIを賢く使うためのポイント

複数人でシステムを開発する現場では、誰が見ても分かりやすいREST APIの設計がプロジェクトの成功を左右します。

直感的なエンドポイント設計： URLは名詞の複数形を基本とし、階層構造（例：`/users/123/orders`）を利用してリソース間の関係性を明確にする。
適切なステータスコードの返却： 成功時は200番台、クライアント側のエラーは400番台、サーバー側のエラーは500番台を正しく使い分ける。
APIのバージョニング： 将来の仕様変更に備えて、URLにバージョン情報を含める（例：`/v1/users`）などし、後方互換性を保つ工夫をする。

アメショと茶トラが腕と背中というお互いのリソースを上手く使ってWin-Winな関係を築いているように、システムの世界でも分かりやすいルールと設計で、フロントエンドとバックエンドが心地よく連携できるREST APIを構築していきましょう。