接口响应状态码整理合集

时间:2025-05-10 08:14:10

前言

     请求后端接口的时候有时因为某些原因会返回一些错误状态码,不同的状态码对应不同的错误信息,为了方便状态码查询与问题定位,梳理总结一下。


目录

 HTTP响应状态码分类

100-199 信息响应

200-299  成功响应

300-399  重定向

400-499  客户端错误

500-505 服务器端错误


 HTTP响应状态码分类

1XX:100-199  信息响应

2XX:200-299  成功响应

3XX:300-399  重定向

4XX:400-499  客户端错误

5XX:500-505 服务器端错误

Ps:加粗行为常见状态码>_<

100-199 信息响应

1xx|表示服务器临时响应,并需要请求者继续执行操作的状态代码

状态码 说明 详情
100 继续请求 初始的请求已经接受,客户应当继续发送请求的其余部分
101 切换协议

服务器将遵从客户的请求转换到另外一种协议

只能切换到更高级的协议 。例如:切换到HTTP的新版本协议

  

200-299  成功响应

2xx | 一般表示请求成功,后端成功处理了请求并返回结果

状态码 说明 详情
200 成功 服务器已成功处理了请求。 通常,这表示服务器提供了请求的网页
201 已创建 请求成功并且服务器创建了新的资源
202 已接受 服务器已接受请求,但尚未处理
203 非授权信息 服务器已成功处理了请求,但返回的信息可能来自另一来源
204 无内容 服务器成功处理了请求,但没有返回任何内容
205 重置内容 服务器成功处理了请求,但没有返回任何内容
206 部分内容 服务器成功处理了部分 GET 请求

300-399  重定向

3xx| 客户端浏览器必须采取更多操作来实现请求

例如:浏览器可能不得不请求服务器上的不同的页面,或通过代理服务器重复该请求

状态码 说明 详情
300 多种选择 服务器可根据请求者 (user agent) 选择一项操作,或提供操作列表供请求者选择
301 永久移动 服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新位置
302 临时移动 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求
303 查看其他位置 请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码
304 未修改 服务器返回此响应时,不会返回网页内容
305 使用代理 服务器返回此响应,还表示请求者应使用代理
307 临时重定向 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求

400-499  客户端错误

4xx |客户端错误,请求包含语法错误或无法完成请求

状态码 说明 详情
400 错误请求 服务器不理解请求的语法:语义有误  请求参数有误
 
401 未授权

请求要求身份验证。

对于需要登录的网页,服务器可能返回此响应

403 禁止 服务器拒绝请求
404 未找到 服务器找不到请求的网页,接口路径错误
405 方法禁用 禁用请求中指定的方法
406 不接受 服务器无法根据客户端请求的内容特性完成请求
407 需要代理授权 请求要求代理的身份认证,与401类似,但请求者应当使用代理进行授权
408 请求超时 服务器等候请求时发生超时
409 冲突 服务器在完成请求时发生冲突。 服务器必须在响应中包含有关冲突的信息
410 已删除 如果请求的资源已永久删除,服务器就会返回此响应
411 需要有效长度 服务器不接受不含有效内容长度标头字段的请求
412 未满足前提条件 服务器未满足请求者在请求中设置的其中一个前提条件
413 请求实体过大 服务器无法处理请求,因为请求实体过大,超出服务器的处理能力
414 请求的URL过长 请求的 URL(通常为网址)过长,服务器无法处理
415 不支持的媒体类型 请求的格式不受请求页面的支持
416 请求范围不符合要求 如果页面无法提供请求的范围,则服务器会返回此状态代码
417 未满足期望值 服务器未满足"期望"请求标头字段的要求
422 不可处理的实体 请求格式正确,但是由于含有语义错误,无法响应
429 请求超出限制 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求

500-505 服务器端错误

5xx| 服务器由于遇到错误而不能完成该请求

状态码 说明 详情
500 服务器内部错误 服务器遇到错误,无法完成请求
501 尚未实施

服务器不具备完成请求的功能。

例如:服务器无法识别请求方法时可能会返回此代码

502 错误网关 服务器作为网关或代理,从上游服务器收到无效响应
503 服务不可用 服务器目前无法使用(由于超载或停机维护)
504 网关超时 服务器作为网关或代理,但是没有及时从上游服务器收到请求
505 HTTP版本不支持 服务器不支持请求中所用的 HTTP 协议版本
506 不接受 服务器有一个内部配置错误:对请求的透明内容协商导致循环引用
507 需要代理授权 服务器有内部配置错误:所选的变体资源被配置为参与透明内容协商本身,因此不是协商过程中的适当端点
508 请求超时 服务器在处理请求时检测到无限循环