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")) |

Defines REST endpoints using Minimal APIs with OpenAPI documentation via Scalar. Use when: Creating or modifying API endpoints in Sorcha services, adding new routes, configuring endpoint authentication, or documenting APIs. Source: stuartf303/sorcha.

View raw