<aside> 💡 Uma API mínima (ou Minimal API) é uma abordagem simplificada para criar APIs HTTP no ASP.NET Core. Ela foi introduzida na versão 6 do ASP.NET Core e é ideal para cenários em que você deseja criar APIs com o mínimo de sobrecarga e dependências.

</aside>

Ambiente Web

1. Criando um Projeto de API Mínima via CLI

Para criar um projeto de API mínima usando o CLI do .NET, siga estas etapas:

• Abra o terminal ou prompt de comando.
• Execute o seguinte comando para criar um novo projeto de API mínima:Isso criará um novo diretório chamado “MinimalApiProject” com a estrutura básica de uma API mínima.

dotnet new web -n MinimalApiProject

Isso criará um novo diretório chamado “MinimalApiProject” com a estrutura básica de uma API mínima.

2. Estrutura Básica de uma API Mínima

A estrutura básica de uma API mínima consiste em um arquivo Program.cs e um arquivo Startup.cs. Vamos focar no Program.cs:

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

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

app.Run();

Neste exemplo, criamos um endpoint que responde com a mensagem “Hello, Minimal API!” quando acessamos a raiz (“/”) da API.

3. Criando Endpoints

Para criar endpoints, utilize os métodos MapGet, MapPost, MapPut, etc. Por exemplo:

app.MapGet("/items", () => "Obter todos os itens");
app.MapPost("/items", () => "Adicionar um novo item");
// ... outros endpoints

4. Recebendo Parâmetros

Pela URL (Query String)

Declare um método para aceitar requisições HTTP GET com parâmetros: