Minimal API の概要

Minimal API は ASP.NET Core で高速 HTTP API を構築する簡単な手法です。 最小のコードと構成で、完全に機能する REST エンドポイントを構築できます。 API のルートとアクションを流暢に宣言することで従来のスキャフォールディングをスキップし、不要なコントローラーを回避します。 たとえば、次のコードでは、テキスト "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();

開始作業はこれで十分ですが、すべてではありません。 Minimal API では、複数の API に拡張するために、複雑なルートを処理するために、認証ルールを適用するために、そして API 応答の内容を制御するために必要な構成とカスタマイゼーションがサポートされます。 「チュートリアル: ASP.NET Core を使って最小 API を作成する」から始めることをお勧めします。

コード例をいくつか参考にしますか?

一般的なシナリオとコード例の完全一覧については、「Minimal API クイック リファレンス」を参照してください。

最初のプロジェクトに直接進みますか?

チュートリアルで最小 API アプリを構築する: 「チュートリアル: ASP.NET Core を使って最小 API を作成する」。