Compartilhar via

Visão geral das APIs mínimas

  • Artigo

Observação

Esta não é a versão mais recente deste artigo. Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Aviso

Esta versão do ASP.NET Core não tem mais suporte. Para obter mais informações, confira .NET e a Política de Suporte do .NET Core. Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Importante

Essas informações relacionam-se ao produto de pré-lançamento, que poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece nenhuma garantia, explícita ou implícita, quanto às informações fornecidas aqui.

Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

APIs mínimas são uma abordagem simplificada para criar APIs de HTTP rápidas com o ASP.NET Core. Você pode criar pontos de extremidade REST totalmente funcionais com o mínimo de codificação e configuração. Declare fluentemente rotas e ações de API para ignorar o scaffolding tradicional e evitar controladores desnecessários. Por exemplo, o código a seguir cria uma API na raiz do aplicativo Web que retorna o texto "Hello World!".

var app = WebApplication.Create(args);

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

app.Run();

A maioria das APIs aceita parâmetros como parte da rota.

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

Isso é tudo o que basta para começar, mas não é tudo o que está disponível. APIs mínimas dão suporte à configuração e à personalização necessárias para dimensionar para várias APIs, lidar com rotas complexas, aplicar regras de autorização e controlar o conteúdo das respostas à API. Um bom lugar para começar é com o Tutorial: Criar uma API mínima com o ASP.NET Core.

Deseja ver alguns exemplos de código?

Para obter uma lista completa de cenários comuns com exemplos de código, confira Referência rápida de APIs mínimas.

Quer ir diretamente ao seu primeiro projeto?

Crie um aplicativo de API mínima com Tutorial: Criar uma API mínima com o ASP.NET Core.