知识卡片

问题卡 · 4927.d.1.a

语义档案描述问题域

理解等级:中级

语义profile列出属性、聚合对象和动作,描述问题空间的规则,供设计期及运行期共享。ALPS可用ontology、taxonomy、choreography标签组织元素,用safe、idempotent、unsafe表达动作语义;具体URL、方法和状态码属于接口实现定义,应留在OpenAPI等文档。响应可公开profile URI,已发布档案若需破坏性修改,应另发新URI并保留旧版。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 超媒体接口设计 · 查看原书依据

      An SPD is a kind of machine-readable interface documentation. SPDs are designed to communicate general elements of the interface (base-level properties, aggregate objects, and actions). SPDs do not contain implementation-level details, such as MQTT topics, HTTP resources, protocol methods, return codes, etc. These details are left to those tasked with writing the actual code that runs behind the interface described by semantic profiles.

    参考来源

    - 位置:《RESTful Web API Patterns and Practices Cookbook Connecting and Orchestrating Microservices and Distributed Data (Mike Amundsen)》第03章《超媒体接口设计》(来源项目 book-sources;源文件:extracted/RESTful Web API Patterns and Practices Cookbook Connecting and Orchestrating Microservices and Distributed Data (Mike Amundsen)/_epub-src/OEBPS/ch03.xhtml;小节:3.4) - 结论依据:原文以语义profile列出属性、聚合对象和动作,描述问题空间的规则,供设计期及运行期共享的机制或场景为依据;同小节余文补充本卡所列条件,按2022年原书语境整理。 - 原始内容:An SPD is a kind of machine-readable interface documentation. SPDs are designed to communicate general elements of the interface (base-level properties, aggregate objects, and actions). SPDs do not contain implementation-level details, such as MQTT topics, HTTP resources, protocol methods, return codes, etc. These details are left to those tasked with writing the actual code that runs behind the interface described by semantic profiles.