REST API，参照标准构建通用易读的接口

REST

Restful api

HTTP动词

对于资源的具体操作类型，由HTTP动词表示。
常用的HTTP动词有下面五个（括号里是对应的SQL命令）：

1. GET（SELECT）：从服务器取出资源（一项或多项）
2. POST（CREATE）：在服务器新建一个资源
3. PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）
4. PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性，比如说某个字段+1）
5. DELETE（DELETE）：从服务器删除资源

还有两个个不常用：

6. HEAD：获取资源的元数据
7. OPTIONS：获取信息，关于资源的哪些属性是客户端可以改变的

HTTP状态码

常用的有下面这些：

• 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 - 由于请求频次达到上限而被拒绝访问

参考资源

1. HTTP动词
2. API接口规范
3. HTTP状态码-百度百科
4. 网上整理的对于Rest和Restful api的理解