官术网_书友最值得收藏!

POST, PUT, and PATCH 

The POST method is used to create a resource on the server. In the previous book's API, this operation creates a new book with the given details. A successful POST operation returns a 201 status code. The POST request can update multiple resources: /v1/books.

The POST request has a body like this: 

{"name" : "Lord of the rings", "year": 1954, "author" : "J. R. R. Tolkien"}

This actually creates a new book in the database. An ID is assigned to this record so that when we GET the resource, the URL is created. So POST should be done only once, in the beginning. In fact, Lord of the Rings was published in 1955. So we entered the published date incorrectly. In order to update the resource, let us use the PUT request.

The PUT method is similar to POST. It is used to replace the resource that already exists. The main difference is that PUT is idempotent. A POST call creates two instances with the same data. But PUT updates a single resource that already exists:

/v1/books/1256

with body that is JSON like this:

{"name" : "Lord of the rings", "year": 1955, "author" : "J. R. R. Tolkien"}

1256 is the ID of the book. It updates the preceding book by year:1955. Did you observe the drawback of PUT? It actually replaced the entire old record with the new one. We needed to change a single column. But PUT replaced the whole record. That is bad. For this reason, the PATCH request was introduced. 

The PATCH method is similar to PUT, except it won't replace the whole record. PATCH, as the name suggests, patches the column that is being modified. Let us update the book 1256 with a new column called ISBN:

/v1/books/1256

with the JSON body like this:

{"isbn" : "0618640150"}

It tells the server, Search for the book with id 1256. Then add/modify this column with the given value.

 PUT and PATCH both return the 200 status for success and 404 for not found.

主站蜘蛛池模板: 农安县| 谢通门县| 莆田市| 甘肃省| 手游| 井陉县| 邯郸县| 云南省| 马龙县| 淮滨县| 神农架林区| 新乡市| 昌图县| 武功县| 望城县| 喀喇| 云阳县| 兰溪市| 博湖县| 屏南县| 云南省| 永宁县| 敦化市| 嵩明县| 务川| 寿光市| 海口市| 乌兰浩特市| 蒙自县| 陕西省| 花莲县| 新平| 万山特区| 福贡县| 邵阳市| 梁河县| 灵寿县| 仙居县| 宝丰县| 利辛县| 武夷山市|