REST APIとは
RESTの原則に基づいて設計されたAPIのこと。
RESTの原則
RESTの原則は、以下の4つである。
- 統一インターフェース
- あらかじめ定義・共有された方法でやり取りすること
- ステートレス性
- やり取りが一回ごとに完結すること
- アドレス可能性
- すべての情報が一意なURIを持っていること
- 接続性
- やり取りされる情報にはハイパーリンクを含めることができること
REST APIの例
RESTのAPIは処理ではなく、リソースに対応してURLが決まる。
例えば、ユーザー情報を取得するAPIは以下のようになる。
GET /users/{user_id}
POST /users
PUT /users/{user_id}
DELETE /users/{user_id}
RESTに従わない場合は、例えば以下のようなAPIになる。
GET /get_user/{user_id}
POST /create_user
PUT /update_user/{user_id}
DELETE /delete_user/{user_id}