知识卡片

普通读书笔记卡

REST接口用资源语义和HTTP方法演进

理解等级:高级

REST接口围绕资源定义稳定契约,以HTTP方法表达读取、创建、完整更新、局部更新和删除;URL用名词描述资源而非动作,并明确版本。接口间避免透传或嵌套彼此内部的数据模型,可把变更影响限制在调用方与提供方。集合过滤和嵌套路由都可用,选择时应让路径表达真实资源语义。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《云原生架构:从技术演进到最佳实践》第18章《应用落地最佳实践》18.5节“API设计与治理”(源文件:_epub-src/text/part0029.html) - 结论依据:coverage段落锚点2–20说明REST约束、HTTP方法、版本URL、资源名词及过滤/嵌套路由语义。 - 原始内容:RESTful API URL是以资源为导向的,而不是描述行为的,因此在设计API时,应使用名词而非动词来描述语义。