REST APIについて簡単にまとめた

REST APIとは

• RESTのルールで作ったAPIのこと。

  • REST

    • URLとHTTPメソッドでリソースへアクセスする考え方（シンプルなWEBシステムの設計思想）。
    • REpresentational State Transfer = 具体的に状態を定義した情報のやり取り
    • 「RESTの４原則」というものがあり、これを満たすものが「RESTfulなシステム」と呼んだりする。「RESTの４原則」は別途後述する。

  • API

    • システムとシステムを繋げる機能（プログラムの情報をやり取りする窓口のようなもの）

• REST APIはRESTful APIを省略した言い方。

  • RESTful APIだったりWEB APIともしばしば呼ばれる。
    

RESTの４原則とREST　APIのまとめ

「RESTの４原則」は字の如く４つの原則からなっている。

• 統一インターフェース

  • あらかじめ定義・共有された方法でやり取りされること。
    • 例えば、「HTTPメソッドでやり取りする〜」・「やり取りする形はJSON形式、HTML形式にしようね〜」みたいな感じ。
  • インターフェースとは？（おまけ）
    • ざっくり言うと、何かと何かがくっつく部分のことを指す。こちらの記事が鬼分かりやすい。
      

• アドレス可能性

  • 全ての情報が一意なURLを持っていて、提供する情報をURLで表現できること。
    

• 接続性

  • やり取りされる情報はハイパーリンクを含めることができる。
    • 1つのリンクから別の情報にリンク（接続）することができる。また、RESTfulなシステム同士なら円滑に情報連携を行うことができる。
      

• ステートレス性

  • 状態（ステート）がないということ。
    • RESTではやりとりが一回ごとに完結する
    • 前のやり取りの結果に影響を受けないシンプルな設計にできるというメリットがある。
      

• REST　APIのまとめ　

  • RESTの４原則に沿ったAPIのこと。
    
    中央のポータルサイトがGoogleのようなサイトでユーザーは住んでいる地域を登録している→この地域情報を敵予報のAPIサーバーに渡して、その地域の天気の情報を検索してポータルサイトに返す。
    （スマホアプリからも同様、使用しているブラウザなどから登録情報を活用してAPIサーバーを叩く）

おわりに

間違い等ございましたらコメント欄にてご指摘ください。

参考記事

• REST APIとは？ざっくりと理解してみる【初心者向け】

• 【簡単に】REST APIとは？初心者もわかりやすく解説

• 「分かりそう」で「分からない」でも「分かった」気になれるIT用語辞典:インターフェース