知识卡片

普通读书笔记卡 · 3545

URL与媒体类型可承载版本

理解等级:高级

API 可把版本放入 URL 路径,便于并行保留旧端点;也可通过 Accept 等协商信息选择表示形式。前者改变资源地址,后者增加协商与错误处理复杂度;应与真实客户端约定稳定规则并测试缓存行为。

这张卡片看不懂?

已有反馈 · 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