HTTP 状态码

状态码是服务器对请求结果的总结，程序无需读取请求体即可根据状态码执行操作。第一个数字表示请求类别：2xx 表示请求成功，3xx 表示请求被重定向，4xx 表示请求错误，5xx 表示服务器故障。其余数字则进一步细化了该类别下的具体含义。

工作原理

客户端首先根据类别进行分支，其次根据具体的错误代码进行分支：处理 2xx 错误，处理 3xx 错误，将 4xx 错误报告给请求的发起者，如果请求是幂等的，则可能会重试 5xx 错误。特定的错误代码包含特定的指令——401 表示身份验证，429 表示减速，412 表示写入前重新读取。

误解

响应体才是真正的答案，代码只是装饰。缓存、代理、重试逻辑、监控和浏览器都直接作用于状态行，而不会读取响应体；一个返回 200 状态码但包含 {"error": …} 的 API 对它们来说都是不可见的，其失败率也同样不可见。

点击这里试试

状态码索引链接了此测试环境返回的每个状态码对应的页面，每个页面都包含生成该状态码的端点。GET /faults/v1/status/{code}请求会返回 200 到 599 之间的任何状态码。

相关内容

• Every HTTP status code, with a live example
• 阴性测试：按需提供所有错误代码

资料来源

• HTTP semantics — RFC 9110
• HTTP caching — RFC 9111

其他术语

• REST API — 将系统建模为可寻址资源的 API，可通过标准 HTTP 方法进行操作。
• API 端点 — 一个 URL 加上一个 HTTP 方法——客户端可以调用的最小 API 单元。
• 查询参数 — URL 中问号后面的键值对，用于过滤、排序、分页或调整端点返回的内容。
• 路径参数 — URL 路径中的可变部分，例如/orders/42中的 42，用于标识一个特定的资源。
• HTTP 标头 — 每个请求和响应都会发送名称-值元数据，与请求体分开。
• 内容谈判 — 客户端和服务器通过标头而不是单独的 URL 来约定响应格式。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日