WSO2 API Manager 4.2.0中API版本与API修订版的区别是什么？

API版本 #

• 面向API消费者的公开标识，对应API的重大功能/业务逻辑变更——比如新增核心接口、修改请求响应的结构规则、调整核心业务流程，这类变更会直接影响消费者的调用代码，必须让消费者主动切换版本适配。
• 每个版本是独立的API实体，拥有独立的访问上下文（比如/v1/orders和/v2/orders），消费者调用时需要明确指定版本路径；旧版本可以独立维护、下线，不影响新版本的运行。

API修订版 #

• 面向API开发/运维人员的内部迭代标识，对应同一API版本下的非契约变更——比如调整网关限流规则、修改API的认证方式、更新API文档、微调网关路由配置，这类变更不会改变API对外暴露的核心契约，消费者完全无需感知。
• 修订版隶属于某个API版本，共享同一个访问上下文，消费者调用时无需指定修订版，默认使用当前激活的最新修订；如果配置变更出问题，可以快速回滚到之前的修订版本。

对你疑问的补充说明 #

你的理解有部分合理性，但需要补充：

• API版本不止对应代码变更：只要是会改变API对外契约、影响消费者调用的变更，都属于版本迭代的范畴（比如业务规则的重大调整，哪怕代码逻辑改动不大）。
• API修订版的变更范围更宽泛：除了API管理器的配置，还包括同一版本下不影响契约的小调整（比如文档更新、非核心参数的描述修改），核心是不破坏消费者的现有调用逻辑。

内容的提问来源于stack exchange，提问作者user666