Partager via

Vue d’ensemble des API minimales

  • Article

Remarque

Ceci n’est pas la dernière version de cet article. Pour la version actuelle, consultez la version .NET 8 de cet article.

Avertissement

Cette version d’ASP.NET Core n’est plus prise en charge. Pour plus d’informations, consultez la Stratégie de prise en charge de .NET et .NET Core. Pour la version actuelle, consultez la version .NET 8 de cet article.

Important

Ces informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Pour la version actuelle, consultez la version .NET 8 de cet article.

Les API minimales sont une approche simplifiée pour la création d’API HTTP rapides avec ASP.NET Core. Vous pouvez créer des points de terminaison REST entièrement fonctionnels avec un minimum de code et de configuration. Ignorez la génération automatique classique et évitez les contrôleurs inutiles en déclarant couramment des routes et des actions d’API. Par exemple, le code suivant crée une API à la racine de l’application web qui retourne le texte, "Hello World!".

var app = WebApplication.Create(args);

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

app.Run();

La plupart des API acceptent des paramètres dans le cadre de l’itinéraire.

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();

C’est tout ce qu’il faut pour commencer, mais ce n’est pas tout ce qui est disponible. Les API minimales prennent en charge la configuration et la personnalisation nécessaires pour effectuer une mise à l’échelle vers plusieurs API, gérer des itinéraires complexes, appliquer des règles d’autorisation et contrôler le contenu des réponses d’API. Un bon point de départ est le Tutoriel : Créer une API minimale avec ASP.NET Core.

Vous souhaitez voir des exemples de code ?

Pour obtenir la liste complète des scénarios courants avec des exemples de code, consultez la Référence rapide sur les API minimales.

Vous voulez vous lancer directement dans votre premier projet ?

Créez une application API minimale avec notre Tutoriel : Créer une API minimale avec ASP.NET Core.