200 |
OK |
请求成功接收并处理,通常响应中都会有 body |
201 |
Created |
请求已完成,并致使了一个或者多个资源被建立,最经常使用在 POST 建立资源的时候 |
202 |
Accepted |
请求已经接收并开始处理,可是处理尚未完成。通常用在异步处理的状况,响应 body 中应该告诉客户端去哪里查看任务的状态 |
204 |
No Content |
请求已经处理完成,可是没有信息要返回,常常用在 PUT 更新资源的时候(客户端提供资源的全部属性,所以不须要服务端返回)。若是有重要的 metadata,能够放到头部返回 |
301 |
Moved Permanently |
请求的资源已经永久性地移动到另一个地方,后续全部的请求都应该直接访问新地址。服务端会把新地址写在 Location 头部字段,方便客户端使用。容许客户端把 POST 请求修改成 GET。 |
304 |
Not Modified |
请求的资源和以前的版本同样,没有发生改变。用来缓存资源,和条件性请求(conditional request)一块儿出现 |
307 |
Temporary Redirect |
目标资源暂时性地移动到新的地址,客户端须要去新地址进行操做,可是不能修改请求的方法。 |
308 |
Permanent Redirect |
和 301 相似,除了客户端不能修改原请求的方法 |
400 |
Bad Request |
客户端发送的请求有错误(请求语法错误,body 数据格式有误,body 缺乏必须的字段等),致使服务端没法处理 |
401 |
Unauthorized |
请求的资源须要认证,客户端没有提供认证信息或者认证信息不正确 |
403 |
Forbidden |
服务器端接收到并理解客户端的请求,可是客户端的权限不足。好比,普通用户想操做只有管理员才有权限的资源。 |
404 |
Not Found |
客户端要访问的资源不存在,连接失效或者客户端伪造 URL 的时候回遇到这个状况 |
405 |
Method Not Allowed |
服务端接收到了请求,并且要访问的资源也存在,可是不支持对应的方法。服务端必须返回 Allow 头部,告诉客户端哪些方法是容许的 |
415 |
Unsupported Media Type |
服务端不支持客户端请求的资源格式,通常是由于客户端在 Content-Type 或者 Content-Encoding中申明了但愿的返回格式,可是服务端没有实现。好比,客户端但愿收到 xml返回,可是服务端支持 Json |
429 |
Too Many Requests |
客户端在规定的时间里发送了太多请求,在进行限流的时候会用到 |
500 |
Internal Server Error |
服务器内部错误,致使没法完成请求的内容 |
503 |
Service Unavailable |
服务器由于负载太高或者维护,暂时没法提供服务。服务器端应该返回 Retry-After 头部,告诉客户端过一段时间再来重试 |