Asp-Net-Core开发笔记：API版本管理
💡
原文中文，约6400字，阅读约需16分钟。
📝
内容提要
本文介绍了在 .Net6.0 的 AspNetCore WebApi 中引入 API 版本管理的方法，包括版本号格式、访问方式和 Swagger 接口文档生成。需要安装 Asp.Versioning.Mvc 和 Asp.Versioning.Mvc.ApiExplorer 两个 NuGet 包，并在 Program.cs 文件中注册服务和配置 API 版本。
🎯
关键要点
- Web API 应用程序需要考虑 API 版本管理，以应对需求变化和功能升级。
- 推荐使用新的 Asp.Versioning.Mvc 包来管理 API 版本，而不是已不再更新的 Microsoft.AspNetCore.Mvc.Versioning 包。
- API 版本可以通过 URL 路径、查询字符串、HTTP 自定义消息头和媒体类型参数等多种方式访问。
- API 版本格式由主版本号和次版本号组成，还可以包含版本组和状态。
- 需要安装 Asp.Versioning.Mvc 和 Asp.Versioning.Mvc.ApiExplorer 两个 NuGet 包。
- 在 Program.cs 文件中注册 API 版本管理服务，设置默认版本和版本读取方式。
- 通过在 Controller 中使用 [ApiVersion] 特性来定义不同版本的 API 接口。
- Swagger 是接口文档的标准，需配置 Swagger 以支持 API 版本管理。
- 测试不同版本的 API 接口，确保版本管理功能正常。
➡️
