知识卡片

普通读书笔记卡 · 1932.p

破坏性版本路由的取舍

理解等级:高级

破坏性API更新需要显式辨别消息格式版本。URL或查询参数易于路由、记录和人工识别;媒体类型能保留实体URL但增加协商与中间件配置;自定义标头灵活但需约定和框架支持;正文版本主要覆盖写请求。版本字段描述消息格式,不应直接等同于应用版本;所有路由采用一致方案可降低调用方记忆负担。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 处理版本问题 · 查看原书依据

      (1) 为URL添加版本辨别字段,可以用前缀形式或查询参数来实现,这是实践中最常见的方法。这种方法的优点是,能轻易地路由到正确的行为;无须任何特殊处理就能共享、存储和通过邮件发送URL;可以通过查询日志,查看随着时间的推移,每个版本使用者的数量;对服务消费者来说,浏览一下URL就能快速确认其正在使用的版本。

    参考来源

    - 位置:《发布!设计与部署稳定的分布式系统(第2版)》第14章《处理版本问题》(来源项目:book-sources;源文件:extracted/发布!设计与部署稳定的分布式系统(第2版)/_epub-src/OEBPS/Text/epub_0023.html) - 结论依据:原文以为URL添加版本辨别字段为定位说明上述机制、对比或案例;本卡依据已读正文解释,未把原包缺失图片当作已观察证据。 - 原始内容:(1) 为URL添加版本辨别字段,可以用前缀形式或查询参数来实现,这是实践中最常见的方法。这种方法的优点是,能轻易地路由到正确的行为;无须任何特殊处理就能共享、存储和通过邮件发送URL;可以通过查询日志,查看随着时间的推移,每个版本使用者的数量;对服务消费者来说,浏览一下URL就能快速确认其正在使用的版本。