Getting Started

1. Install the NuGet package into your ASP.NET Core project: > dotnet add package MinimalApis.Extensions
2. .NET 6.0 projects only In your project's Program.cs, call the AddEndpointsMetadataProviderApiExplorer() method on builder.Services to enable enhanced endpoint metadata in ApiExplorer: var builder = WebApplication.CreateBuilder(args); builder.Services.AddEndpointsMetadataProviderApiExplorer(); // <-- Add this line in .NET 6.0 projects builder.Services.AddSwaggerGen(); ...
3. Update your Minimal APIs to use the filters, binding, and result types from this library, e.g.: app.MapPut("/todos/{id}", async Task<Results<NotFound, NoContent>> (int id, Todo todo, TodoDb db) => { var existingTodo = await db.Todos.FindAsync(id); if (existingTodo is null) return TypedResults.NotFound(); existingTodo.Title = todo.Title; existingTodo.IsCompleted = todo.IsCompleted; await db.SaveChangesAsync(); return TypedResults.NoContent(); }) .WithParameterValidation();

What's Included?

This library provides types that help extend the core functionality of ASP.NET Core Minimal APIs in the following ways:

• Enhanced parameter binding via IParameterBinder and Bind<TValue>, Body<TValue>, JsonFormFile, and others
• Extra result types available via Results.Extensions including PlainText, Html, and UnsupportedMediaType
• For .NET 7.0 apps, an endpoint filter that validates route handler parameters and auto-responds with validation problem if validation fails
• Poly-filling of .NET 7.0 features for use in .NET 6.0 projects including:
  • Typed IResult objects for easier unit testing (available via TypedResults) including the IStatusCodeHttpResult, IContentTypeHttpResult, and IValueHttpResult interfaces
  • Automatic population of detailed endpoint descriptions in Swagger/OpenAPI via the ability for input and result types to populate endpoint metadata via IEndpointParameterMetadataProvider and IEndpointMetadataProvider
  • Union IResult return types via Results<TResult1, TResultN> that enable route handler delegates to declare all the possible IResult types they can return, enabling compile-time type checking and automatic population of all possible responses in Swagger/OpenAPI from type information

Sample Projects

TodoApis.Dapper

An example Todos application using ASP.NET Core Minimal APIs and the Dapper library for data storage in SQLite.

MinimalApis.Examples

Contains small examples for other types in this library.

MinimalApiPlayground

Shows many examples of using the types in this library along with other things related to ASP.NET Core Minimal APIs.