Menu
CoddyTech

Parámetros de ruta

Parte de la sección API mínimas del Journey de ASP.NET Core de Coddy. Lección 3 de 20.

Una ruta por receta no terminaría nunca. Un parámetro de ruta es una parte de la ruta entre llaves: coincide con cualquier valor en ese lugar.

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

GET /orders/42 responde Order 42. ASP.NET Core pasa el valor al parámetro de la lambda con el mismo nombre y convierte el texto 42 al tipo del parámetro, que aquí es int. Si el nombre de un parámetro no está en la ruta, se busca en la cadena de consulta; si tampoco está allí, la respuesta es 400 Bad Request. Un código de estado es el número al principio de cada respuesta: 200 significa OK y los códigos del 400 al 499 significan que la solicitud era incorrecta.

challenge icon

Desafío

Fácil

Cada receta tiene su propia dirección: /api/recipes/1, /api/recipes/2 y así sucesivamente.

  1. En Program.cs, debajo de GET /api/recipes, asigna GET /api/recipes/{id}.
  2. Su lambda recibe int id y devuelve la receta cuyo Id es igual a id. recipes.FirstOrDefault(r => r.Id == id) la encuentra.

Pruébalo: pulsa Ejecutar. GET /api/recipes/2 responde {"id":2,"name":"Pancakes","category":"breakfast","minutes":15}. Envía GET /api/recipes/99: ninguna receta tiene ese id, así que FirstOrDefault devuelve null y la respuesta tiene el estado 200 y el cuerpo null. El siguiente capítulo devuelve 404 en este caso.

Pruébalo tú mismo

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 las lecciones de API mínimas