HTTP Status Code
HTTP 状态码
HTTP 状态码是响应中的三位数字,用来说明请求的标准结果,以及它属于哪一类结果。
另一个例子
导入 API 还在处理时返回 202 和状态 URL;立即创建成功时返回 201 与 `Location`;版本冲突返回 409;CSV 字段内容不符合规则则返回 422。JSON 问题内容可补充有用细节,但不会改变状态码的含义。
主要部分
- 01状态类别
- 02已注册代码
- 03响应元数据和内容
什么时候用
返回最符合结果的精确已注册状态码,并按需要加入有用的响应头和固定格式的错误内容。
什么时候不要用
不要让每个业务失败都返回 200,也不要用过于具体的错误泄露敏感的授权信息。
代码里的名称
1xx informational, 2xx success, 3xx redirection, 4xx client, 5xx server 上线前要检查
检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。
预期结果:为这套系统设计或检查 HTTP 状态码 (HTTP Status Code),并让数据保持正确、安全且容易维护。 用户场景:导入 API 还在处理时返回 202 和状态 URL;立即创建成功时返回 201 与 `Location`;版本冲突返回 409;CSV 字段内容不符合规则则返回 422。JSON 问题内容可补充有用细节,但不会改变状态码的含义。 技术概念或控制措施:HTTP 状态码 (HTTP Status Code)。 适用理由:返回最符合结果的精确已注册状态码,并按需要加入有用的响应头和固定格式的错误内容。 不应使用的情况:不要让每个业务失败都返回 200,也不要用过于具体的错误泄露敏感的授权信息。 工程要求:定义输入、输出、接口约定,以及任何情况下都不能破坏的规则。说明授权与输入检查范围。定义失败、超时、重试和重复执行只生效一次的规则。也要定义数据迁移与兼容限制。 运营要求:加入监控信号与隐藏敏感数据的日志。设置容量上限并写好操作手册。测试恢复与回到上一版的流程。 验收标准:接口约定与失败路径测试通过。重试或部分失败时,数据与授权规则仍正确。性能上限、监控、恢复与回到上一版的方法都已验证。 证据与限制(证据边界):标准只涵盖列出的范围,不会替你决定外观、产品做法或 Vibulary 的教学示例。 待确认:程序运行环境、数据位置、流量形态、数据一致需求和安全边界。也要确认兼容周期、服务目标(SLO)与恢复上一版的限制。
检查这份需求
请 AI 编程助手检查当前如何使用 HTTP 状态码 (HTTP Status Code)。 定义:HTTP 状态码是响应中的三位数字,用来说明请求的标准结果,以及它属于哪一类结果。 生产环境检查:检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。