そのため、HTTP PUTリクエストは、特定のURIに現在保存されているリソースを置き換えるために発行されることがよくあります。たとえば、https://example.org/book/1に保存されている本があり、データは次のようにJSONで表すことができます。
$ curl --request GET https://example.org/book/1
{
"title": "Stackoverflow Compilation Book 1",
"year": 2019
}
架空の本が昨年(2018年)に出版されたためにフィールドを修正したいとします。その人はyear
、HTTPPUTリクエストを介して完全に更新された本の情報を送信する必要があります。
$ curl --request PUT
--header "Content-Type: application/json"
--data '{"title": "Stackoverflow Compilation Book 1", "year": 2018}'
year
属性の変更に注意してください。
HTTP PUTリクエストは本質的に置換操作であると考えると、URIで表される本を別のものに置き換えることもできます。例えば、
$ curl --request PUT
--header "Content-Type: application/json"
--data '{"title": "Some random book that nobody publishes", "year": 2019}'
Content-Type
添付データは、サポートされている限り、任意の形式(通常は上記のように要求ヘッダーでも指定)にすることができ、通常はAccept
応答ヘッダー(アプリケーションが処理するデータ型の種類を示す)によって報告されます。 。送信されたデータが有効かどうかを判断するために、アプリケーションコードによってさらに検証が処理されます。