知识卡片
REST接口用资源语义和HTTP方法演进
REST接口围绕资源定义稳定契约,以HTTP方法表达读取、创建、完整更新、局部更新和删除;URL用名词描述资源而非动作,并明确版本。接口间避免透传或嵌套彼此内部的数据模型,可把变更影响限制在调用方与提供方。集合过滤和嵌套路由都可用,选择时应让路径表达真实资源语义。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《云原生架构:从技术演进到最佳实践》第18章《应用落地最佳实践》18.5节“API设计与治理”(源文件:_epub-src/text/part0029.html)
- 结论依据:coverage段落锚点2–20说明REST约束、HTTP方法、版本URL、资源名词及过滤/嵌套路由语义。
- 原始内容:RESTful API URL是以资源为导向的,而不是描述行为的,因此在设计API时,应使用名词而非动词来描述语义。