Sdílet prostřednictvím

Přehled minimálních rozhraní API

  • Článek

Poznámka:

Toto není nejnovější verze tohoto článku. Aktuální verzi najdete v tomto článku ve verzi .NET 9.

Upozorňující

Tato verze ASP.NET Core se už nepodporuje. Další informace najdete v tématu .NET a .NET Core Zásady podpory. Aktuální verzi najdete ve verzi .NET 8 tohoto článku.

Důležité

Tyto informace se týkají předběžného vydání produktu, který může být podstatně změněn před komerčním vydáním. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Aktuální verzi najdete v tomto článku ve verzi .NET 9.

Minimální rozhraní API představují zjednodušený přístup k vytváření rychlých rozhraní API HTTP s ASP.NET Core. Můžete vytvářet plně funkční REST koncové body s minimálním kódem a konfigurací. Přeskočte tradiční generování uživatelského rozhraní a vyhněte se zbytečným kontrolerů tím, že deklarují trasy a akce rozhraní API. Například následující kód vytvoří rozhraní API v kořenovém adresáři webové aplikace, která vrátí text. "Hello World!"

var app = WebApplication.Create(args);

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

app.Run();

Většina rozhraní API přijímá parametry jako součást trasy.

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

To je vše, co je potřeba začít, ale není to všechno, co je k dispozici. Minimální rozhraní API podporují konfiguraci a přizpůsobení potřebné ke škálování na více rozhraní API, zpracování složitých tras, použití autorizačních pravidel a řízení obsahu odpovědí rozhraní API. Dobrým místem, kde začít, je kurz: Vytvoření minimálního rozhraní API s ASP.NET Core.

Chcete se podívat na příklady kódu?

Úplný seznam běžných scénářů s příklady kódu najdete v rychlých referenčních informacích k minimálním rozhraním API.

Chcete rovnou přejít na první projekt?

V našem kurzu sestavte minimální aplikaci API: Kurz: Vytvoření minimálního rozhraní API s ASP.NET Core