在API 中,经常使用的code码

状态码 Label 解释
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 头部,告诉客户端过一段时间再来重试
相关文章
相关标签/搜索