Menu
CoddyTech

Restrições de rota

Parte da seção APIs mínimas do Journey de ASP.NET Core da Coddy. Lição 4 de 20.

GET /orders/abc corresponde a /orders/{number}, mas falha ao converter abc para um int: 400 Solicitação Inválida. Uma restrição de rota após dois-pontos limita o que um parâmetro corresponde, então esse caminho não corresponde a nenhuma rota e retorna 404 Não Encontrado.

app.MapGet("/orders/{number:int}", (int number) => $"Order {number}");
app.MapGet("/orders/{code:alpha}", (string code) => $"Code {code}");

:int corresponde a números inteiros e :alpha corresponde a letras, então /orders/7 e /orders/abc alcançam, cada um, uma rota. Outras opções são :guid, :min(1) e :length(3), e elas podem ser encadeadas: {number:int:min(1)}. As restrições escolhem uma rota; elas não verificam a entrada de um usuário, porque um valor recusado retorna 404, não 400.

challenge icon

Desafio

Fácil

GET /api/recipes/abc responde com 400 e um erro sobre a vinculação de int id. Nenhuma receita jamais terá esse endereço, então a resposta deveria ser 404.

  1. Em Program.cs, altere a rota do endpoint da lição anterior para /api/recipes/{id:int}.
  2. Mantenha uma única rota para ele: altere a linha existente, não adicione uma segunda.

Experimente: pressione Executar: GET /api/recipes/2 ainda responde com a receita Pancakes. Envie GET /api/recipes/abc: status 404 e corpo vazio. A lista Routes mostra GET /api/recipes/{id:int}.

Experimente você mesmo

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

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", () => recipes);
app.MapGet("/api/recipes/{id}", (int id) => recipes.FirstOrDefault(r => r.Id == id));

app.Run();
quiz iconTeste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de APIs mínimas