描述 HTTP 动词描述操作

野性酷女 2022-06-01 08:49 164阅读 0赞

HTTP 设计了很多动词，来表示不同的操作，RESTful 很好的利用的这一点，我们需要正确的使用 HTTP 动词，来表明我们要如何操作资源。  
先来解释一个概念，`幂等性`，指一次和多次请求某一个资源应该具有同样的副作用，也就是一次访问与多次访问，对这个资源带来的变化是相同的。

常用的动词及幂等性

<table style="margin:25px 0px; line-height:30px; display:block; overflow:auto; color:rgb(99,107,111); font-family:'Hiragino Sans GB',Helvetica,'Microsoft YaHei','Hiragino Sans GB',Arial,sans-serif; font-size:15px"> 
 <thead> 
  <tr style="border-top:1px solid rgb(204,204,204)"> 
   <th style="padding:6px 13px">动词</th> 
   <th style="padding:6px 13px">描述</th> 
   <th style="padding:6px 13px">是否幂等</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr style="border-top:1px solid rgb(204,204,204)"> 
   <td style="padding:6px 13px">GET</td> 
   <td style="padding:6px 13px">获取资源，单个或多个</td> 
   <td style="padding:6px 13px">是</td> 
  </tr> 
  <tr style="background-color:rgb(248,248,248); border-top:1px solid rgb(204,204,204)"> 
   <td style="padding:6px 13px">POST</td> 
   <td style="padding:6px 13px">创建资源</td> 
   <td style="padding:6px 13px">否</td> 
  </tr> 
  <tr style="border-top:1px solid rgb(204,204,204)"> 
   <td style="padding:6px 13px">PUT</td> 
   <td style="padding:6px 13px">更新资源，客户端提供完整的资源数据</td> 
   <td style="padding:6px 13px">是</td> 
  </tr> 
  <tr style="background-color:rgb(248,248,248); border-top:1px solid rgb(204,204,204)"> 
   <td style="padding:6px 13px">PATCH</td> 
   <td style="padding:6px 13px">更新资源，客户端提供部分的资源数据</td> 
   <td style="padding:6px 13px">否</td> 
  </tr> 
  <tr style="border-top:1px solid rgb(204,204,204)"> 
   <td style="padding:6px 13px">DELETE</td> 
   <td style="padding:6px 13px">删除资源</td> 
   <td style="padding:6px 13px">是</td> 
  </tr> 
 </tbody> 
</table>

> 为什么 PUT 是幂等的而 PATCH 是非幂等的，因为 PUT 是根据客户端提供了完整的资源数据，客户端提交什么就替换为什么，而 PATCH 有可能是根据客户端提供的参数，动态的计算出某个值，例如每次请求后资源的某个参数减1，所以多次调用，资源的会有不同的变化。
> 
> 在开发API接口时，对应的状态吗的含义:
> 
>  *  200 OK - 对成功的 GET、PUT、PATCH 或 DELETE 操作进行响应。也可以被用在不创建新资源的 POST 操作上
>  *  201 Created - 对创建新资源的 POST 操作进行响应。应该带着指向新资源地址的 Location 头
>  *  202 Accepted - 服务器接受了请求，但是还未处理，响应中应该包含相应的指示信息，告诉客户端该去哪里查询关于本次请求的信息
>  *  204 No Content - 对不会返回响应体的成功请求进行响应（比如 DELETE 请求）
>  *  304 Not Modified - HTTP缓存header生效的时候用
>  *  400 Bad Request - 请求异常，比如请求中的body无法解析
>  *  401 Unauthorized - 没有进行认证或者认证非法
>  *  403 Forbidden - 服务器已经理解请求，但是拒绝执行它
>  *  404 Not Found - 请求一个不存在的资源
>  *  405 Method Not Allowed - 所请求的 HTTP 方法不允许当前认证用户访问
>  *  410 Gone - 表示当前请求的资源不再可用。当调用老版本 API 的时候很有用
>  *  415 Unsupported Media Type - 如果请求中的内容类型是错误的
>  *  422 Unprocessable Entity - 用来表示校验错误
>  *  429 Too Many Requests - 由于请求频次达到上限而被拒绝访问
> 
>   
>