知识卡片
GET查询不应执行状态更新
GET 的约定是读取资源而不改变其状态。书中的电商 API 反例允许以 GET 调用名为 item.update 的方法修改商品,违反了这个约定。即使接口采用自定义 RPC 风格,也应让会改变状态的操作使用合适的方法,并在接口说明中写明副作用;否则只看 HTTP 方法的客户端或基础设施会误判其行为。这个例子与[[HTTP方法承载不同操作语义]]的 GET 安全性要求相反。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入实践DDD:以DSL驱动复杂软件开发》第149章《13.1.2 尽可能使用HTTP作为封包》(源文件:_epub-src/OEBPS/Text/chapter151.xhtml)
- 结论依据:原文明确指出该 API 的修改状态方法也可用 GET 调用,并给出商品更新请求作为反例;上一小节把 GET 定义为不会改变资源状态的安全操作。
- 原始内容:更夸张的是,这个SaaS的开放API中所有的方法,包括修改状态的方法,都可以使用HTTP GET调用。比如,可以通过发送一个GET请求到这个URL来更新商品信息