REST APIとは、Webサービス同士が情報をやり取りするときの「決めごと」をそろえた作り方です。たとえば、アプリがサーバーに「このデータをください」と頼み、サーバーが「はい、これです」と返す流れを、わかりやすい形でそろえます。まずは、REST APIが何をしているのかを、クライアントとサーバーの関係からつかみましょう。
REST APIの基本
APIは、ざっくり言うと「別のソフトとやり取りするための窓口」です。RESTは、その窓口を作るときの考え方の一つです。よくあるREST APIでは、URLで「何を扱うか」を表し、HTTPメソッドで「何をしたいか」を表します。たとえば、読むならGET、追加するならPOST、更新するならPUTやPATCH、削除するならDELETEです。
返ってくるデータは JSON 形式がよく使われます。JSONは、機械が読みやすく、人も目で追いやすい形のデータです。そして、うまくいったか、失敗したかは HTTPステータスコード で見分けます。REST APIを理解するときは、この3つ、つまり「URL」「HTTPメソッド」「返ってくる結果」をセットで見ると整理しやすくなります。
よくある疑問：REST APIって、ただのAPIと何が違うんですか？
APIはやり取りの窓口、RESTはその窓口の作り方の考え方です。URLで対象を表し、GETやPOSTで操作を分ける、と覚えると十分です。
身近なたとえで考える
REST APIは、図書館の貸し出し窓口にたとえるとわかりやすいです。あなたは「この本を見せてください」と窓口に頼みます。これがGETに近い動きです。窓口の人は、書庫から本を探して、見つかったら渡してくれます。もし新しい本を登録するならPOST、内容を差し替えるならPUTやPATCH、棚から外すならDELETEのイメージです。
ここで大事なのは、窓口の人が毎回ちがうやり方で対応すると、利用者が困ることです。だから、REST APIは「このURLならこの種類の操作」「返事はこの形」というように、ルールをそろえます。すると、クライアント側のアプリは作りやすくなり、サーバー側も保守しやすくなります。見た目は小さな約束でも、Webサービス同士では大きな助けになります。
実務ではどう使うのか
実際の現場では、たとえばネットショップのアプリが商品の一覧を取りに行ったり、会員情報を更新したりするときにREST APIを使います。ブラウザやスマホアプリのようなクライアントが、APIサーバーへリクエストを送り、サーバーが必要なデータだけ返します。画面はその結果を受けて、一覧を出したり、エラーを表示したりします。
このとき、JSONで返ってきた中身を見れば、どんな情報が入っているかを確認しやすくなります。もし失敗したら、まずはステータスコードを見ます。成功なのか、見つからないのか、権限がないのかがわかるからです。くわしい原因を探すときは、レスポンスだけでなく ログ も見ます。開発中は、実際にAPIをたたいて テスト しながら、送信した内容と返ってきた内容が合っているかを確かめます。
REST APIは、ただデータを送るだけではありません。「何を取りたいか」「何を変えたいか」「うまくいったか」を、誰が見てもたどりやすい形にそろえる役目があります。だから、チームで開発するときほど役立ちます。フロントエンド、バックエンド、スマホアプリが分かれていても、共通のルールで話せるからです。
図解で整理
REST APIは、下の流れで考えると見やすくなります。クライアントが「どのURLに、どんな操作をしたいか」を送ると、サーバーが中身を確認して、必要ならデータベースを見に行きます。そのあと、結果をJSONで返し、HTTPステータスコードで成功か失敗かを知らせます。つまり、住所、用件、返事の3点がそろうと理解しやすいです。
ここでのURLは「どのデータか」を示す住所、HTTPメソッドは「何をするか」を示す用件、JSONは「返すデータの形」、HTTPステータスコードは「返事の札」です。たとえば、同じ商品情報でも、取得するときと更新するときでは操作が違います。REST APIでは、その違いをメソッドで分けるので、見た目がすっきりします。
ただし、REST APIだからといって、必ず全部が同じ形とは限りません。会社やサービスによって、認証の方法や返す項目は少しずつ違います。大事なのは、基本の考え方をつかんでおくことです。URLで対象を示し、HTTPメソッドで操作を分け、JSONとステータスコードで結果を返す。この流れを押さえれば、初めて見るAPIでも読み解きやすくなります。
クイズで確認しよう
Q1. REST APIで、データを「読む」ときによく使うHTTPメソッドはどれ？
- A. GET
- B. POST
- C. PUT
- D. DELETE
答えを見る
答え：GETです。データを取得するときによく使います。
Q2. サーバーから返ってきた結果を見て、成功か失敗かを確かめる目印はどれ？
- A. URL
- B. HTTPステータスコード
- C. CSS
- D. 画像サイズ
答えを見る
答え：HTTPステータスコードです。200台なら成功、400台や500台ならエラーの可能性を考えます。
Q3. REST APIで、データをやり取りするときによく使う形式はどれ？
- A. JSON
- B. Excel
- C. PDF
- D. PNG
答えを見る
答え：JSONです。機械が扱いやすく、Webサービスで広く使われます。
まとめ
REST APIは、Webサービス同士が情報をやり取りするときの基本ルールです。URLで対象を表し、HTTPメソッドで操作を分け、JSONでデータを返し、HTTPステータスコードで結果を伝えます。まずはこの4点を覚えるだけでも、APIの見え方がかなり変わります。次にAPIを見るときは、「何を取りたいのか」「どう返ってくるのか」を意識して読んでみましょう。
