← 返回卡片

原书出处

RESTful Web API Patterns and Practices Cookbook Connecting and Orchestrating Microservices and Distributed Data (Mike Amundsen)

02 用超媒体思考与设计

First Edition · 核验版本的摘录快照 · 导入于 2026-11-14T06:41:15.483Z

Don’t redefine things. You cannot change the meaning or use of an existing element of the interface. For example, if the response message was published as a user object, you cannot change it to a user collection. If the output property count was documented as containing the number of records in the collection, you cannot change its meaning to the number of records on a single page response. Make additions optional. After the initial publication of the API, any additional inputs or outputs must be documented as optional—you cannot add new required properties for existing interfaces.

此预览只包含定位所需的摘录和上下文。

原书定位详情

来源:a19c7933-4eda-4176-aebd-30fe7e1ad292

正文位置:extracted/RESTful Web API Patterns and Practices Cookbook Connecting and Orchestrating Microservices and Distributed Data (Mike Amundsen)/_epub-src/OEBPS/ch02.xhtml

EPUB SHA-256:db552473a29e61f8a9429a17bbb5c0a47985d7cbbfd2d402bce45fc4b11ee389