用途:介绍在 .NET 10 中构建最小 API(Minimal APIs)的推荐做法,把最小 API 作为构建 HTTP 端点的默认方式,仅迁移遗留代码时才用控制器。
主要能力:用 MapGroup 将相关端点分组,避免在 Program.cs 中散落 MapGet/MapPost;用 TypedResults 获得编译期类型安全与正确的 OpenAPI 文档;用 .WithName()、.WithTags()、.WithSummary() 等元数据替代注释来丰富 OpenAPI 规范。文档还涵盖参数绑定(路由、查询、请求头、正文与 DI 自动解析,复杂查询用 [AsParameters])、端点过滤器(替代 Action 过滤器,用于验证、日志、幂等检查,验证过滤器放在 error-handling skill 中复用)、OpenAPI/Swagger 配置(.NET 10 内置支持,使用 AddOpenApi/MapOpenApi 而非 Swashbuckle)、速率限制与输出缓存。
使用方式:文中推荐必用模式是端点组自动发现——每个端点组实现 IEndpointGroup 并单独成文件,Program.cs 只调用一次 app.MapEndpoints() 自动注册所有实现,新增功能时 Program.cs 不变。示例展示 OrderEndpoints 通过 MapGroup 定义 POST/GET 端点并配置 Produces、RequireAuthorization、AddEndpointFilter 等;OpenAPI 元数据在端点上通过 WithName、WithSummary、Produces 配置。
适用场景:新建 HTTP API 使用 IEndpointGroup + 自动发现;现有 MVC 项目保留控制器并逐步迁移;需要 OpenAPI 文档、请求验证、认证授权、速率限制、响应缓存或复杂模型绑定。
限制与反模式:不要把端点散落在 Program.cs;不要使用无类型 Results(不贡献 OpenAPI 架构);不要直接返回领域实体,应映射为响应 DTO。其他具体平台、收费、价格与效果信息暂未提供。