POST和PUT请求的区别

目录

幂等性

创建资源

更新资源

缓存

一个例子

---

在设计REST API时，许多人在选择HTTP的PUT方法或POST方法时都感到困惑，因为他们的功能相似，但是我们还是有必要搞清楚他们的区别。

幂等性

PUT方法是幂等性的，所以我们如果对资源多次提交或者进行重试，他和我们只执行一次效果是一样的。

而POST方法不是幂等性的，这意味着如果我们进行N次提交，这就意味着在服务端创建了N个资源，从而有N个URL。

创建资源

由幂等性引申过来，PUT方式如果请求URI引用的是已经存在的资源，那么将进行更新操作；如果请求URI是一个存在资源的URI，则应该进行创建操作。

PUT /questions/{question-id}

对于POST请求，请求的URI通常应该是一个集合URI，表示资源的集合。

POST /questions

更新资源

当我们想要修改已经存在于资源集合中的部分时，应使用PUT方法，PUT方法会完全更新资源。如果请求只更新资源的一部分，则应使用PATCH方法。

如果是POST进行更新的时候，一般是在资源下创建子资源。

缓存

因为PUT方式是幂等性的，所以一般不应该缓存PUT请求的响应。

默认情况下，对POST方法的响应是不可缓存的，除非响应头中包含Cache-Control或Expires字段。

一个例子

GET 	/device-management/devices       : 获取所有设备
POST 	/device-management/devices       : 创建一个新的设备

GET 	/device-management/devices/{id}   : 根据ID获取设备信息
PUT 	/device-management/devices/{id}   : 根据ID更新设备信息
DELETE	/device-management/devices/{id}   : 根据ID删除设备