用途:帮助创建结构良好、类型正确且具备完整 OpenAPI/Swagger 文档的 ASP.NET Minimal API 端点。
主要能力:API 组织方面,可用 MapGroup() 扩展对相关端点分组,用端点过滤器处理横切关注点,将较大 API 拆分为独立端点类,复杂 API 可采用基于功能的文件夹结构。请求与响应类型方面,定义显式请求/响应 DTO 或模型,创建带验证特性的模型类,使用 record 类型表示不可变对象,属性命名符合 API 设计规范,应用 [Required] 等验证特性,并用 ProblemDetailsService 与 StatusCodePages 获得标准错误响应。类型处理方面,使用强类型路由参数与显式类型绑定,用 Results<T1, T2> 表示多种响应类型,返回 TypedResults 而非 Results,并利用 C# 10+ 的可空注解与 init-only 属性。OpenAPI 文档方面,使用 .NET 9 内置的 OpenAPI 文档支持,定义操作摘要与描述,通过 WithName 扩展方法添加 operationId,用 [Description()] 为属性和参数添加说明,设置正确的请求与响应内容类型,使用文档转换器添加 servers、tags、安全方案等元素,使用架构转换器自定义 OpenAPI 架构。
使用方式与限制:资料未提供具体安装命令、代码示例或调用步骤,暂未提供。