Minimal-APIs – Übersicht

Hinweis

Dies ist nicht die neueste Version dieses Artikels. Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.

Warnung

Diese Version von ASP.NET Core wird nicht mehr unterstützt. Weitere Informationen finden Sie in der .NET- und .NET Core-Supportrichtlinie. Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.

Wichtig

Diese Informationen beziehen sich auf ein Vorabversionsprodukt, das vor der kommerziellen Freigabe möglicherweise noch wesentlichen Änderungen unterliegt. Microsoft gibt keine Garantie, weder ausdrücklich noch impliziert, hinsichtlich der hier bereitgestellten Informationen.

Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.

Minimal-APIs stellen einen vereinfachten Ansatz zum Erstellen schneller HTTP-APIs mit ASP.NET Core dar. Sie können voll funktionsfähige REST-Endpunkte mit minimalem Aufwand bei Code und Konfiguration erstellen. Vergessen Sie den herkömmlichen Gerüstbau und unnötige Controller, indem Sie API-Routen und -Aktionen fließend deklarieren. Der folgende Code erstellt beispielsweise eine API am Stamm der Web-App, die den Text "Hello World!" zurückgibt.

var app = WebApplication.Create(args);

app.MapGet("/", () => "Hello World!");

app.Run();

Die meisten APIs akzeptieren Parameter als Teil der Route.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.MapGet("/users/{userId}/books/{bookId}", 
    (int userId, int bookId) => $"The user id is {userId} and book id is {bookId}");

app.Run();

Das ist alles, was Sie für den Einstieg benötigen, aber nicht alles, was verfügbar ist. Minimal-APIs unterstützen die Konfiguration und Anpassung, die für eine Skalierung auf mehrere APIs, die Verarbeitung komplexer Routen, die Anwendung von Autorisierungsregeln und die Steuerung des Inhalt von API-Antworten erforderlich ist. Das Tutorial: Erstellen einer minimalen Web-API mit ASP.NET Core ist ein guter Einstiegspunkt.

Benötigen Sie einige Codebeispiele?

Eine vollständige Liste gängiger Szenarien mit Codebeispielen finden Sie in der Kurzreferenz zu Minimal-APIs.

Möchten Sie direkt mit Ihrem ersten Projekt beginnen?

Erstellen Sie eine App mit einer minimalen API mit unserem Tutorial: Erstellen einer minimalen API mit ASP.NET Core.