Minimal API の概要

Note

これは、この記事の最新バージョンではありません。 現在のリリースについては、この記事の .NET 9 バージョンを参照してください。

警告

このバージョンの ASP.NET Core はサポート対象から除外されました。 詳細については、「.NET および .NET Core サポート ポリシー」を参照してください。 現在のリリースについては、この記事の .NET 8 バージョンを参照してください。

重要

この情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft はここに示されている情報について、明示か黙示かを問わず、一切保証しません。

現在のリリースについては、この記事の .NET 9 バージョンを参照してください。

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 を作成する」。