ASP.NET Core 中使用 Swagger 实现 API 分组管理
💡
原文中文，约3000字，阅读约需8分钟。
📝
内容提要
在 ASP.NET Core 开发中，使用 Swagger 生成和展示 API 文档至关重要。通过 [ApiExplorerSettings] 和 [Tags] 特性，可以对 API 进行版本和功能模块分组，从而提升文档的可读性。配置 Swagger 后，用户可以在 Swagger UI 中查看不同版本和模块的 API 操作。
🎯
关键要点
- 在 ASP.NET Core 开发中，Swagger 是生成和展示 API 文档的重要工具。
- 使用 [ApiExplorerSettings] 特性可以将 API 操作分组到不同版本，提升文档可读性。
- 在控制器上添加 [ApiExplorerSettings] 特性并指定 GroupName 来实现版本分组。
- 在 Startup.cs 中配置 Swagger，为每个版本生成文档并匹配 GroupName。
- 启用 Swagger UI 后，可以查看不同版本的 API 文档。
- 使用 [Tags] 特性可以将同一版本的 API 操作分组到不同功能模块。
- 在控制器上添加 [Tags] 特性并指定模块名称来实现功能模块分组。
- Swagger 会自动识别 [Tags] 特性，无需额外配置。
- 启动应用后，Swagger UI 中的 API 操作会按 [Tags] 分组显示。
➡️
