API版本管理方式多种多样
| 序号 | 版本管理方式 | 简要说明 |
|---|---|---|
| 1 | 域名区分管理 | 不同版本使用不同域名，v1.api.amap.com，v2.api.amap.com |
| 2 | 请求URL path区分管理 | 同一域名，api.amap.com/v1/，api.amap.com/v2/ |
| 3 | 请求参数区分管理 | 同一域名，请求参数中带version=v1/v2/v3等，然后识别具体版本执行对应方法 |
各方式的优缺点
| 序号 | 版本管理方式 | 优点 | 缺点 |
|---|---|---|---|
| 1 | 域名区分管理 | 1、采用多应用部署，不同版本接口完全隔离；2、部署在一个应用上，通过域名识别进行分发 | 1、函数不能复用；2、函数能复用 |
| 2 | 请求URL path区分管理 | 可以创建不同的controllers，功能水平扩展，不影响老版本 | |
| 3 | 请求参数区分管理 | 功能水平扩展，不影响老版本 |
版本管理的一点思考
API日常接口变更不可避免，但若变更太频繁，就要思考最初的需求是不是有问题，变更API版本的目的是什么，每个版本使用用户都不同等等方面的问题；
如果不同版本的API仅是功能更强大了，比如原来不支持附件上传，新版本支持附件上传，这种场景的API版本变更就没意义，更合理的是单独发布一个附件上传的接口，降低功能间的耦合。
在开发接口时始终要记住一点：尽量将功能的颗粒度降到最低（需求分析、模块设计阶段），不要做多功能融合的接口。