Http常用请求方法对比

请求方法 常见参数传递方式 是否幂等 说明 API举例
GET URL,注意:Http协议对URL长度没有限制,所谓的限制是浏览器和处理服务器的 幂等 用于查询

批量查询:/shapes

单个查询:/shapes/{shapeId}

POST RequestBody 不幂等 一般用于创建

创建资源:/shapes

PUT RequestBody 幂等

一般用于修改,也可以用于创建,客户端提供更新或创建完整信息

因此对于修改,由于PUT是幂等的,尽量使用PUT而不是POST

创建时需指定创建的Id,保证创建操作的幂等性,否则应该使用POST

创建资源:/shapes/1

修改资源:/shapes/1

PATCH RequestBody 不幂等

用于修改,客户端只提供修改信息

例如:参数为长度+2,正因如此,Patch不幂等

修改资源:/shapes/1

DELETE URL 幂等 用于删除

删除资源:/shapes/1