Condividi tramite

Panoramica delle API minime

  • Articolo

Nota

Questa non è la versione più recente di questo articolo. Per la versione corrente, vedere la versione .NET 9 di questo articolo.

Avviso

Questa versione di ASP.NET Core non è più supportata. Per altre informazioni, vedere i criteri di supporto di .NET e .NET Core. Per la versione corrente, vedere la versione .NET 9 di questo articolo.

Importante

Queste informazioni si riferiscono a un prodotto non definitive che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Per la versione corrente, vedere la versione .NET 9 di questo articolo.

Le API minime sono un approccio semplificato per la creazione di API HTTP veloce con ASP.NET Core. È possibile compilare endpoint completamente funzionanti REST con codice e configurazione minimi. Ignorare lo scaffolding tradizionale ed evitare controller non necessari dichiarando in modo fluente le route e le azioni dell'API. Ad esempio, il codice seguente crea un'API nella radice dell'app Web che restituisce il testo . "Hello World!"

var app = WebApplication.Create(args);

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

app.Run();

La maggior parte delle API accetta parametri come parte della 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();

È tutto quello che serve per iniziare, ma non è tutto ciò che è disponibile. Le API minime supportano la configurazione e la personalizzazione necessarie per passare a più API, gestire route complesse, applicare regole di autorizzazione e controllare il contenuto delle risposte api. Un buon posto per iniziare è Esercitazione: Creare un'API minima con ASP.NET Core.

Vuoi vedere alcuni esempi di codice?

Per un elenco completo degli scenari comuni con esempi di codice, vedere Informazioni di riferimento rapido sulle API minime.

Vuoi passare direttamente al tuo primo progetto?

Creare un'app per le API minima con l'esercitazione Esercitazione: Creare un'API minima con ASP.NET Core.