# 最少的 API 技能 Sorcha 专门使用 .NET 10 Minimal API，从不使用 MVC 控制器。所有端点均通过“MapGroup()”路由分组以及“Endpoints/”文件夹中的扩展方法进行组织。 OpenAPI 文档使用 **Scalar** （不是 Swagger）。 ## 快速入门 ### 具有授权的路由组 // src/Services/Sorcha.Wallet.Service/Endpoints/WalletEndpoints.cs 公共静态 IEndpointRouteBuilder MapWalletEndpoints（此 IEndpointRouteBuilder 应用程序） { var walletGroup = app.MapGroup("/api/v1/wallets") .WithTags("钱包") .RequireAuthorization("CanManageWallets"); walletGroup.MapPost("/", CreateWallet) .WithName("创建钱包") .WithSummary("创建一个新钱包") .WithDescription("使用指定算法创建一个新的HD钱包"); walletGroup.MapGet("/{地址}", GetWallet) .WithName("获取钱包") .WithSummary("通过地址获取钱包"); 返回应用程序； } ### 带 DI 的端点处理程序私有静态异步任务 CreateWallet( [FromBody] CreateWalletRequest 请求， WalletManager 钱包管理器, HttpContext 上下文， ILogger<程序> 记录器， CancellationToken 取消令牌 = 默认） { 尝试 { var (钱包, 助记词) = wait walletManager.CreateWalletAsync(...); return Results.Created($"/api/v1/wallets/{wallet.Address}", response); } catch (ArgumentException 前) { return Results.BadRequest(new ProblemDetails { Title = "无效请求", Detail = ex.Message }); } } ## 关键概念概念|用途 |示例 ---|---|--- 路线组 |相关端点的共享配置 | `app.MapGroup("/api/v1/wallets").WithTags("钱包")` 键入结果 |类型安全的返回值 | `结果<确定，未找到，验证问题>` OpenAPI 元数据 | `.WithName()`、`.WithSummary()` |所有端点都需要授权| `.RequireAuthorization("策略")` |适用于组或单个端点允许匿名 |公共端点 |登录路由上的“.AllowAnonymous()” 缓存输出| Redis 输出缓存 | `.CacheOutput(p => p.Expire(...).Tag("tag"))` ## 常见模式 ### 显式返回类型的 TypedResults 私有静态异步任务<结果，UnauthorizedHttpResult，ValidationProblem>>登录（ LoginRequest请求， ITokenService 令牌服务） { if (string.IsNullOrWhiteSpace(request.Email)) 返回 TypedResults.ValidationProblem(new Dictionary { ["电子邮件"] = ["电子邮件为必填项"] }); var token = wait tokenService.LoginAsync(request); if (token == null) return TypedResults.Unauthorized(); 返回 TypedResults.Ok(令牌); } ### 具有默认值的查询参数 walletGroup.MapGet("/{address}/addresses", ListAddresses); 私有静态异步任务 ListAddresses( string 地址, // 路由参数 [FromQuery] 字符串？ type = null, // 可选过滤器 [FromQuery] 布尔？ used = null, // 可选过滤器 [FromQuery] int page = 1, // 默认分页 [FromQuery] int pageSize = 50) ## 另请参阅 * [patterns]() \- 端点组织、错误处理、缓存 * [workflows]() \- 创建新端点，添加授权 ## 相关技能 * 请参阅 **aspire** 服务编排和配置技能 * 请参阅 OpenAPI 文档 UI 的 **标量** 技能 * 请参阅 **jwt** 技能进行身份验证和授权设置 * 输出缓存配置参见**redis**技巧 * 请参阅 **signalr** 技能以获取实时端点通知 ## 文档资源 > 使用 Context7 获取最新的 ASP.NET Core Minimal API 文档。 **如何使用Context7：** 1.使用`mcp__context7__resolve-library-id`搜索“aspnetcore” 2. 优先使用“/websites/learn_microsoft_en-us_aspnet_core”官方文档 3. 使用“mcp__context7__query-docs”进行查询 **库 ID：** `/websites/learn_microsoft_en-us_aspnet_core` **推荐查询：** *“最小api路由组” *“最小 api 输入结果” *“最小API授权” *“最小 api openapi 文档”

最小蜜蜂

包含技能