minimal-apis

SKILL.md

Sorcha uses .NET 10 Minimal APIs exclusively—NEVER MVC controllers. All endpoints are organized via MapGroup() route grouping with extension methods in Endpoints/ folders. OpenAPI documentation uses Scalar (NOT Swagger).

| Route Groups | Shared config for related endpoints | app.MapGroup("/api/v1/wallets").WithTags("Wallets") | | TypedResults | Type-safe return values | Results , NotFound, ValidationProblem> | | OpenAPI Metadata | .WithName(), .WithSummary() | Required on all endpoints |

| Authorization | .RequireAuthorization("Policy") | Apply to groups or individual endpoints | | AllowAnonymous | Public endpoints | .AllowAnonymous() on login routes | | Cache Output | Redis output caching | .CacheOutput(p => p.Expire(...).Tag("tag")) |

Scalar を介した OpenAPI ドキュメントを使用して、最小限の API を使用して REST エンドポイントを定義します。 次の場合に使用します: Sorcha サービスでの API エンドポイントの作成または変更、新しいルートの追加、エンドポイント認証の構成、または API の文書化。 ソース: stuartf303/sorcha。

原文を見る