安全

URI 的定义

URI 是对一个资源的指向，同一个资源必须使用同一个 URI，不同的资源使用不同的 URI。资源的处理使用动词，GET（查询）、POST（创建）、PUT（全局更新）、PATCH（局部更新）、DELETE（删除）。

字段前缀”-“表示降序

?sort=-create_time,id

不返回 content,keywords 信息

?fields=content,keywords

三种方式

Content-Type 为 application/json，否则响应返回 415 Unsupported Media Type

客户端请求错误使用 400 系列状态码，服务端响应错误使用 500 系列状态码。

状态码	注解
200	请求资源成功
201	同步处理资源的新建或修改成功，返回包含新资源地址的 Location 头
202	资源的新建或修改进入异步
204	不返回响应主体的成功请求的响应，例如，资源删除成功
206	返回了部分资源
400	请求格式、参数缺失或者错误
401	没有权限
403	访问被禁止
404	资源不存在
405	所请求的 HTTP 方法不允许当前认证用户访问
406	请求的数据格式不存在
410	资源被永久删除
415	请求的媒体类型错误
422	请求理解成功，但是参数验证错误
429	请求频率超限
500	服务器内部错误

关于调用频率的一个例子：

X-Rate-Limit-Limit：当前时间段内允许的最多请求次数
X-Rate-Limit-Remaining：当前时间段内剩余的请求次数
X-Rate-Limit-Reset：还有多少秒，请求次数限制会被重置

目前大部分使用“X-”前缀来区分自定义与非自定义的 HTTP 头，RFC 6848 已经开始废弃这种做法，但目前依然可用。