ASP.NET Core 6.0 最小 API / Swagger 标签

Question

有没有办法更改用最少的 api 编写的给定

http

方法的标签？

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

...

app.MapGet("/todo", () => "Hello world");

这样我就可以在文档中对方法进行逻辑分组，类似于它们在控制器中的方法。

已编辑

我尝试过（来自@Modar Na的提示）

SwaggerOperation

，不幸的是它没有帮助。

app.MapGet("/todo", [SwaggerOperation(Tags = new[] { "ToDo" })]() => "Hello world");
app.MapPost("/todo", [SwaggerOperation(Tags = new[] { "ToDo" })]() => "Hello world");

app.MapGet("/projects", [SwaggerOperation(Tags = new[] { "Projects" })]() => "Hello world");
app.MapPost("/projects", [SwaggerOperation(Tags = new[] { "Projects" })]() => "Hello world");

更新了

作为解决方法，我在配置 swagger 生成器时使用了

TagActionsBy

方法。

builder.Services.AddSwaggerGen(c =>
{
    c.TagActionsBy(d =>
    {
        return new List<string>() { d.ActionDescriptor.DisplayName! };
    });
});

请参阅我的博客文章。

Answer 1

怎么样

WithTags

:

app.MapGet("/todo", () => "Hello world").WithTags("ToDo");

Answer 2

我认为共享同一路线的所有操作都会默认分组

但是要明确定义组，您需要使用 swagger 标签，可以像这样使用：

app.MapGet("/todo", [SwaggerOperation(Tags = new[] { "MyTag" })]() => "Hello world");

控制器方法链接