使用 Swashbuckle 创建 OpenAPI 规范中控制器、方法和标签的嵌套结构

Question

问题是，我有一个 ASP.Net Core Web API 应用程序，它使用 Swashbuckle 的 SwaggerGen 来生成 OpenAPI 规范。有控制器，例如EmployeesController 和ProductsController。每个里面都有方法，比如 get/edit/del/等等。如何使这些控制器显示在 SwaggerUI 中的实体标签下，使其具有这样的层次结构 - Entities->[EmployeesController, ProductsController, ...]->[get, edit, del, ...]？

我尝试过使用 SwaggerTag 和 SwaggerOperation 属性与 Tag 属性，但我达到的唯一结果是将所有方法都放在 Entities 标签下，但所有方法都显示在 Entities 下的列表中，没有控制器。

Answer 1

问题已得到解答。我决定重新组织文档结构，以便它不需要嵌套标签。

OpenAPI 规范和 Swagger UI 不支持嵌套标签。 – 海伦