HTTP Method
HTTP 方法
HTTP 方法是请求中的一个词,用来说明想做哪一种操作。每个方法都有关于安全性、重试和缓存的标准规则。
另一个例子
文档 API 用 `GET` 读取而不改变数据,用 `PUT` 替换已知资源,用 `PATCH` 修改一部分,再用 `DELETE` 请求删除。链接检查器可以安全发送 `HEAD`。爬虫绝不能因为调用 `GET` 就批准发票。
主要部分
- 01方法令牌
- 02既定语义
- 03目标资源
什么时候用
选择标准语义符合操作的已注册方法,并写清楚前置条件、数据格式和响应方式。
什么时候不要用
不要用安全方法改变数据。如果缓存和其他中间系统需要标准语义,也不要把所有操作都塞进 `POST`。
代码里的名称
GET, HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE, PATCH 上线前要检查
检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。
预期结果:为这套系统设计或检查 HTTP 方法 (HTTP Method),并让数据保持正确、安全且容易维护。 用户场景:文档 API 用 `GET` 读取而不改变数据,用 `PUT` 替换已知资源,用 `PATCH` 修改一部分,再用 `DELETE` 请求删除。链接检查器可以安全发送 `HEAD`。爬虫绝不能因为调用 `GET` 就批准发票。 技术概念或控制措施:HTTP 方法 (HTTP Method)。 适用理由:选择标准语义符合操作的已注册方法,并写清楚前置条件、数据格式和响应方式。 不应使用的情况:不要用安全方法改变数据。如果缓存和其他中间系统需要标准语义,也不要把所有操作都塞进 `POST`。 工程要求:定义输入、输出、接口约定,以及任何情况下都不能破坏的规则。说明授权与输入检查范围。定义失败、超时、重试和重复执行只生效一次的规则。也要定义数据迁移与兼容限制。 运营要求:加入监控信号与隐藏敏感数据的日志。设置容量上限并写好操作手册。测试恢复与回到上一版的流程。 验收标准:接口约定与失败路径测试通过。重试或部分失败时,数据与授权规则仍正确。性能上限、监控、恢复与回到上一版的方法都已验证。 证据与限制(证据边界):标准只涵盖列出的范围,不会替你决定外观、产品做法或 Vibulary 的教学示例。 待确认:程序运行环境、数据位置、流量形态、数据一致需求和安全边界。也要确认兼容周期、服务目标(SLO)与恢复上一版的限制。
检查这份需求
请 AI 编程助手检查当前如何使用 HTTP 方法 (HTTP Method)。 定义:HTTP 方法是请求中的一个词,用来说明想做哪一种操作。每个方法都有关于安全性、重试和缓存的标准规则。 生产环境检查:检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。