最小API的Swagger

您可以使用 WithTags 扩展方法:

OpenAPI支持使用标签对象进行分类 operations 这些标签通常用于对Swagger UI中的操作进行分组。这些标签可以通过调用 WithTags 端点上具有所需标签的扩展方法。

app.MapGet("/one", () => "Hello World!").WithTags("xyz");
app.MapGet("/two", () => "Hello World!").WithTags("xyz");

它搭配得很好 MapGroup :

这个 地图集团 扩展方法有助于使用通用前缀组织端点组。它减少了重复的代码,并允许通过对以下方法的单个调用来定制整个端点组 RequireAuthorization 和 WithMetadata 其添加端点元数据。

var adminGroup = app.MapGroup("/admin")
    .WithTags("admin");
adminGroup.MapGet("/adminThing", () => "some");
adminGroup.MapPost("/doAdminThing", () => "some1");

var userGroup = app.MapGroup("/user")
    .WithTags("user");
userGroup.MapGet("/userThing", () => "some");
userGroup.MapPost("/doUserThing", () => "some1");

您可以使用 .WithOpenApi() 扩展,例如

app.MapGet("/", ...)
 .WithOpenApi(o => {Tags = new List<string>{"Section1"}})