Общие сведения о минимальных API

Примечание.

Это не последняя версия этой статьи. В текущем выпуске см . версию .NET 8 этой статьи.

Предупреждение

Эта версия ASP.NET Core больше не поддерживается. Дополнительные сведения см. в статье о политике поддержки .NET и .NET Core. В текущем выпуске см . версию .NET 8 этой статьи.

Внимание

Эта информация относится к предварительному выпуску продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

В текущем выпуске см . версию .NET 8 этой статьи.

Минимальные API — это упрощенный подход к созданию быстрых API-интерфейсов HTTP с помощью ASP.NET Core. Вы можете создавать полностью функционируют REST конечные точки с минимальным кодом и конфигурацией. Пропустить традиционные шаблонные шаблоны и избежать ненужных контроллеров путем свободного объявления маршрутов и действий API. Например, следующий код создает API в корне веб-приложения, возвращающего текст "Hello World!".

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. Хорошим местом для начала работы является руководство. Создание минимального API с помощью ASP.NET Core.

Хотите просмотреть некоторые примеры кода?

Полный список распространенных сценариев с примерами кода см . в кратком справочнике по минимальным API.

Хотите перейти прямо в свой первый проект?

Создайте минимальное приложение API с помощью нашего руководства. Руководство. Создание минимального API с помощью ASP.NET Core.