POST
リソース
の
削除
・
新規作成
・
更新
など
サーバ
側が広く自由に処理して良い.
一般に
冪等性
がなく,
キャッシュ
の対象とならない.
主には
リソース
の
新規作成
に用いられており,
RFC 7231
では
サーバ
は
201(Created)
を返しつつ
Locationフィールド
に
URI
を返すべきであるとされている.
code:server
# 新規 articles レコードを作成するリクエスト
POST /articles HTTP/1.1
{
"name": "Foo",
"author": "hankehly",
"content": "123"
}
# id=12 の articles レコードが作成されたことを伝えるレスポンス
HTTP/1.1 201 Created
Location:
http://example.com/articles/12