目录
在设计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进行更新的时候,一般是在资源下创建子资源。
一个例子
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删除设备