HTTPプロトコルにおけるREST API

一般に、ウェブサイトを作成する際、 データの取得、作成、変更、削除には、 ブラウザやサーバーでよくサポートされている GETメソッドとPOSTメソッドのみが使用されます。 これは、サイトが提供するAPIについても同じです。 しかし、API開発者とそのユーザーの双方の利便性を高めるために、 APIを標準化する特別なアプローチが存在します。

そのアプローチの一つがREST APIです （しばしば形容詞としてRESTfulという言葉が使われます）。 このAPIの基礎は、HTTPプロトコルのメソッドを広範に使用することにあります。 このアプローチでは、GETメソッドでデータを取得し、 POSTメソッドで作成し、 PUTメソッドで変更し、 DELETEメソッドで削除します。

例として、ユーザーを操作するあるAPIについて考えてみましょう。 さまざまなアクションに対するURLがどのように見えるかを見てみます。

すべてのユーザーを取得する:

urlGET http://api.loc/users/

ユーザーをidで1人取得する:

urlGET http://api.loc/user/1/

ユーザーを作成する:

urlPOST http://api.loc/user/

ユーザーをidで変更する:

urlPUT http://api.loc/user/1/

ユーザーをidで削除する:

urlDELETE http://api.loc/user/1/