API 版本管理的重要性不言而喻，对于 API 的设计者和使用者而言，版本管理都有着非常重要的意义。下面会从 WEB API 版本管理的角度提供几种常见办法：
首先，对于 API 的设计和实现者而言，需要考虑向后兼容性，但是随着业务的发展或需求的变更往往会导致兼容性实现非常复杂，因此引入 API 版本管理将能解决这个尴尬。下面提供多个版本管理的 API 实现，不需要再为了向后兼容性而绞尽脑汁。其次，对于 API 的使用者而言，也可以灵活选择使用不同版本 API，而不用担心 API 的兼容性问题。
WEB API 版本化的五种方式:
方式一：利用 URL
HTTP GET:
https://banbenguanli.com/api/…
方式二：利用用户自定义的 request header
HTTP GET:
https://banbenguanli.com/api/…
api-version: 2
方式三：利用 content type
HTTP GET:
https://banbenguanli.com/api/…
Accept: application/vnd.banbenguanli.v2+json
方式四：利用 content type，把版本号分离出来了
HTTP GET:
https://banbenguanli.com/api/…
Accept: application/vnd.banbenguanli+json; version=2.0
方式五：利用 URL 里的 parameter
HTTP GET:
https://banbenguanli.com/api/…
API 版本控制策略
任何不断发展变化的 API 都需要 API 版本控制策略。API 版本可以适应根据 API 使用者的期望而切换不同版本变得有所不同。建议将以下 API 版本控制策略作为整体 API 管理系统的一部分。
- 1. 如果 API 处于早期测试版本，为了获得消费者的反馈，请建立 API 各种可能发生的期望。在此阶段内，你会保留这个版本一段时间，因为你的 API 设计可能还会更改。作为消费者，API 是不稳定的，因此他们应该预期到可能会发生的变化。
- 2. 一旦发布，API 应被视为契约，如果没有新版本，则不能被替换。
- 3. 突破性的变化意味着客户必须迁移到新版本，请与 API 使用者沟通更新日期，以确保他们能方便地迁移到新版本。但在某些情况下，新版本的迁移不会马上实现，因此以前的 API 版本会被继续使用一段时间。
实现版本控制的工具
使用工具和技术可以从根本上实现 API 版本控制过程。用市场上优秀的 API 编辑器将使技术开发团队能够在更短的时间内生成并切换更多的 API 版本，从而不断改进设计决策。
结合工具进行版本控制是大多数开发过程的重要组成部分。API 设计领域中也有这种能版本控制的工具，实际上，全球范围内 API 服务领域中已经存在一些优秀的 Web API 设计工具。
现在，如 EOLINKER、RAML、Swagger，都提供了出色的编辑工具来支持他们的语言。EOLINKER 采用的是版本对比和重点标注提示，可以清晰的切换、对比。RAML、Swagger 采用的是版本切换，方便程度可能略逊一点。而且只有前者是支持中文的，后两种只支持英文语言。这些 API 编辑器都能轻松地实现 API 版本的控制，使得更容易在更短的时间内切换运行版本。点击查看。
参考资料：
https://dzone.com/articles/wh…
https://cloud.tencent.com/dev…
https://blog.csdn.net/hengyun…