最小 API 概觀

基本 API 是使用 ASP.NET Core 建置快速 HTTP API 的簡化方法。 您可以使用最少的程式碼和設定，來建置功能完整的 REST 端點。 透過流暢地宣告 API 路由和動作，略過傳統的 Scaffolding 並避免不必要的控制器。 例如，下列程式碼會在傳回文字 "Hello World!" 的 Web 應用程式根目錄建立 API。

var app = WebApplication.Create(args);

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

app.Run();

大部分的 API 都會接受參數作為路由的一部分。

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

這是開始作業所需的一切，但可用的項目不只如此。 最低 API 支援縮放至多個 API、處理複雜路由、套用授權規則，以及控制 API 回應內容所需的設定和自訂。 開始使用的絕佳起點是教學課程：使用 ASP.NET Core 建立基本的 API。

想要查看一些程式碼範例嗎？

如需程式碼範例常見情節的完整清單，請參閱基本 API 快速參考。

想要直接跳到您的第一個專案嗎？

使用教學課程建置基本的 API 應用程式：教學課程：使用 ASP.NET Core 建立基本 API。