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.
Desafio
FácilGET /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.
- Em
Program.cs, altere a rota do endpoint da lição anterior para/api/recipes/{id:int}. - 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();
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
1Primeiros Endpoints
Seu primeiro EndpointRetornando JSON2Resultados e corpos JSON
OK e não encontrado