关于Web API 版本控制的一些想法

一、版本数量

出于对维护成本考虑，API版本数量最好有个限制，比如只保留最新的5个API版本

二、版本有效期

针对每个API版本，设置一个使用期限标识。比如最新的API版本已经更新到了V9，但是有的用户还在使用V1的老版本，这个时候需要某种机制来强制升级用户版本。

三、同一个版本的兼容性问题

有时候只是作了一次很小的改动，比如更改了接口返回中某个字段的名称，此时没有必要将它发布为一个新版本，这种情况下如何保证兼容性？

四、前端调用

可以将版本信息放在url或者请求头中

五、后端维护

后端需要同时维护最新的几个API版本，可以考虑为每个版本建立一个子目录