RESTful

https://e-words.jp/w/RESTful_API.html
REST(REpresentational State Transfe - 代表的な状態の転送)は、API仕様ではなく以下の設計原則のこと。
URIでアクセスできる
・(リクエストが)ステートレスである
・情報に、別の情報のURLリンクを含められる
・取得、作成、更新、削除に、HTTPメソッド(GET、POST、PUT、DELETE)を利用する
RESTfulAPIは、上記の原則を満たしたWebAPI。
厳密な定義があるわけではなく、GET、POST、PUT、DELETEでhttpリクエストを投げてそれに対応する操作を行って結果を返すのがRESTful API くらいの意味。
応答は、XML、HTML、JSONCSV、プレーンテキストなどなんでもいい。



REST定義にあるわけではないが以下のような作りをすることが多い。
・URLは複数形で定義
・応答をhttpステータス(データ無しなら404とか)で戻す
・PUTで更新をしたらその更新結果を応答として得る(更新結果を改めてGETしなくていい)