知识卡片
API版本平衡双方升级成本
同时维护旧版让消费者按需迁移,却增加生产者的补丁和运维负担;原地升级省去多版本维护,但破坏性变更可能要求所有消费者同步修改。API 版本策略应明确哪些变化可原地发布、哪些必须提供迁移窗口,并记录双方承担的成本。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
Older applications continue to operate against the older version of the APIs. This is fine from a consumer perspective, as the consumer only upgrades to the new location and API if they need the new features. However, the owner of the API needs to maintain and manage multiple versions of the API, including any patching and bug fixing that might be necessary.
参考来源
- 位置:《Mastering API Architecture》第1章《Design, Build, and Specify APIs》之《API Versioning》(源文件:_epub-src/OEBPS/ch01.xhtml)
- 结论依据:原文比较旧版并存、兼容增加和破坏性原地变化三条路径,分别讨论消费者迁移、生产者维护与同步升级代价。
- 原始内容:Older applications continue to operate against the older version of the APIs. This is fine from a consumer perspective, as the consumer only upgrades to the new location and API if they need the new features. However, the owner of the API needs to maintain and manage multiple versions of the API, including any patching and bug fixing that might be necessary.