1 客户端请求的API版本和服务器端API版本不是一一对应的
2 客户端请求的API版本可能为1.0, 1.1, 2.0, 2.1…… 而服务器端最多维护3个大版本,比如 1.x, 2.x, 3.x,当超过三个版本,则废弃掉最低的版本,同时强制客户端升级。
3 服务器端维护的版本(最多三个)是通过不同二级域名来访问的,
比如:1.x: https://v1.api.your-domain.com
2.x: https://v2.api.your-domain.com
3.x: https://v3.api.your-domain.com
4 小版本迭代(比如:1.0升级到1.1,服务器端对应提供的API为1.x), 可能面临API新增和废弃的情况,如果是API废弃,则在注释一栏明确标明 @deprecated,已便下一个大版本升级的时候将其从代码中移除。