知识卡片
URL与媒体类型可承载版本
API 可把版本放入 URL 路径,便于并行保留旧端点;也可通过 Accept 等协商信息选择表示形式。前者改变资源地址,后者增加协商与错误处理复杂度;应与真实客户端约定稳定规则并测试缓存行为。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《Microservice APIs》附录 B《Managing an API’s life cycle》(源文件:_epub-src/OEBPS/Text/B.htm)
- 结论依据:原文比较 URL 版本与 Accept 版本的可发现性、地址变化和解析成本。
- 原始内容:Versioning using the URL —You can embed the API version in the URL, for example, https://coffeemesh.com/api/v1/coffee . This is very convenient because consumers of your API know that they will always be able to call the same