关键信息
- 分类
- 开发与 Web
- 输入类型
- select, text
- 输出类型
- html
- 样本覆盖
- 4
- 支持 API
- Yes
概览
本工具提供完整的 HTTP 状态码（1xx–5xx）速查参考，帮助开发者快速检索各个状态码的官方语义、典型应用场景以及客户端重试建议，提升 API 设计与网络排障效率。
适用场景
- •在设计 RESTful API 并需要为不同的业务结果选择最符合规范的 HTTP 响应状态码时。
- •在分析服务器日志或调试网络请求，遇到不常见的状态码（如 409、429 或 503）需要确认其具体含义和重试策略时。
- •前端开发人员需要根据接口返回的状态码编写全局拦截器或错误处理逻辑时。
工作原理
- •在分类筛选下拉菜单中选择特定的状态码区间（如 2xx 成功、4xx 客户端错误或 5xx 服务端错误）以缩小浏览范围。
- •在搜索框中输入状态码数字、英文短语或中文描述，实时过滤出匹配的参考条目。
- •查看筛选结果中每个状态码的详细语义、典型触发场景以及针对该状态码的客户端重试建议。
使用场景
接口设计规范制定：后端开发人员参考状态码语义，规范化 API 响应设计。
网络故障排查：运维人员通过分析 Nginx 或网关日志中的状态码，快速定位请求失败原因。
前端异常捕获：前端开发人员根据状态码（如 401、403、429）编写统一的 Axios 拦截器逻辑。
用户案例
1. 设计 RESTful API 的错误响应
后端开发工程师- 背景原因
- 正在设计一套新的用户注册与登录 API，需要针对邮箱已存在、密码错误、请求频率过快等场景返回标准的 HTTP 状态码。
- 解决问题
- 不确定应该使用哪些具体的 4xx 状态码来区分这些客户端错误。
- 如何使用
- 在分类筛选中选择 '4xx 客户端错误'，并在搜索框中分别搜索 'conflict' 和 'too many'。
- 示例配置
-
categoryFilter: "4xx", search: "conflict" - 效果
- 确认了邮箱已存在应返回 409 Conflict，请求频率过快应返回 429 Too Many Requests，并获取了相应的重试处理建议。
2. 排查线上服务偶发性 502 报错
运维工程师- 背景原因
- 监控系统报警显示，部分用户在访问支付接口时遇到了 502 Bad Gateway 错误。
- 解决问题
- 需要快速了解 502 错误的根本原因以及是否可以安全地进行客户端重试。
- 如何使用
- 在搜索框中直接输入 '502'，查看该状态码的详细语义和重试建议。
- 示例配置
-
categoryFilter: "all", search: "502" - 效果
- 明确了 502 表示网关从上游服务器收到了无效响应，通常不建议立即无脑重试，而应采用指数退避算法重试，并重点排查上游应用服务的健康状况。
用 Samples 测试
development常见问题
401 Unauthorized 和 403 Forbidden 有什么区别？
401 表示未提供身份验证凭证或凭证无效，通常需要登录；403 表示已识别身份但无权访问该资源。
遇到 503 Service Unavailable 状态码时应该重试吗？
应该。503 通常是临时性的服务器超载或维护，客户端可以配合 Retry-After 响应头在稍后进行重试。
什么是 301 和 302 重定向的区别？
301 是永久重定向，浏览器会缓存新地址；302 是临时重定向，后续请求仍应访问原 URL。
429 Too Many Requests 状态码代表什么？
代表客户端在给定的时间内发送了太多请求，触发了服务器的限流策略，需要等待一段时间后再请求。
如何快速找到特定状态码的重试建议？
您可以直接在搜索框中输入状态码（如 502），或筛选 5xx 分类，即可在结果表格中直接查看对应的重试策略。