Menu
CoddyTech

Parâmetros de rota

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

Uma rota por receita nunca teria fim. Um parâmetro de rota é uma parte do caminho entre chaves: ele corresponde a qualquer valor nesse lugar.

app.MapGet("/orders/{number}", (int number) => $"Order {number}");

GET /orders/42 responde Order 42. ASP.NET Core passa o valor para o parâmetro lambda com o mesmo nome e converte o texto 42 para o tipo do parâmetro, neste caso, int. Um parâmetro cujo nome não está na rota é procurado na string de consulta; se também não estiver lá, a resposta é 400 Solicitação Inválida. Um código de status é o número no início de cada resposta: 200 significa OK, e os códigos de 400 a 499 significam que a solicitação estava incorreta.

challenge icon

Desafio

Fácil

Cada receita tem seu próprio endereço: /api/recipes/1, /api/recipes/2 e assim por diante.

  1. Em Program.cs, abaixo de GET /api/recipes, mapeie GET /api/recipes/{id}.
  2. A lambda recebe int id e retorna a receita cujo Id é igual a id. recipes.FirstOrDefault(r => r.Id == id) a encontra.

Experimente: pressione Executar. GET /api/recipes/2 retorna {"id":2,"name":"Pancakes","category":"breakfast","minutes":15}. Envie GET /api/recipes/99: nenhuma receita tem esse id, então FirstOrDefault retorna null e a resposta tem status 200 com o corpo null. O próximo capítulo retorna 404 para esse caso.

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

Todas as lições de APIs mínimas