使用 dotnet 6.0 使用最少的 API 时如何在 Swagger UI 中添加方法描述？

Question

This link 有关于如何将文档添加到 swagger 中的惊人文档 UI。

link 的问题是它没有说明如何使用最少的 API 来做到这一点。互联网上有很多地方展示了如何向 swagger UI 添加文档，例如，但我无法使用最小的 api 来做到这一点。

This video 展示了如何使用最少的 api 创建一个简单的项目：
This video 显示如何使其可单元测试
This last video 显示如何添加验证、授权和身份验证

有没有人设法使用最少的 API 将自定义文档添加到 swagger UI 中？

Answer 1

根据 Microsoft 文档，支持最小 api。

app.MapGet("/api/todoitems/{id}", async (int id, TodoDb db) =>
         await db.Todos.FindAsync(id) 
         is Todo todo
         ? Results.Ok(todo) 
         : Results.NotFound())
   .Produces<Todo>(StatusCodes.Status200OK)
   .Produces(StatusCodes.Status404NotFound);

您可以在此处找到更多信息：

https://docs.microsoft.com/en-us/aspnet/core/fundamentals/minimal-apis?view=aspnetcore-6.0#openapi

使用 dotnet 6.0 使用最少的 API 时如何在 Swagger UI 中添加方法描述？

How to add method description in Swagger UI when using minimal APIs using dotnet 6.0?

swagger

.net-core

openapi