Restricciones de ruta
Parte de la sección API mínimas del Journey de ASP.NET Core de Coddy. Lección 4 de 20.
GET /orders/abc coincide con /orders/{number}, pero falla al convertir abc en un int: 400 Bad Request. Una restricción de ruta después de dos puntos limita con qué coincide un parámetro, de modo que esa ruta no coincide con ninguna ruta y responde 404 Not Found.
app.MapGet("/orders/{number:int}", (int number) => $"Order {number}");
app.MapGet("/orders/{code:alpha}", (string code) => $"Code {code}");:int coincide con números enteros y :alpha coincide con letras, así que /orders/7 y /orders/abc llegan cada uno a una ruta. Otras son :guid, :min(1) y :length(3), y se pueden encadenar: {number:int:min(1)}. Las restricciones eligen una ruta; no validan la entrada de un usuario, porque un valor rechazado responde 404, no 400.
Desafío
FácilGET /api/recipes/abc responde con 400 y un error sobre la vinculación de int id. Ninguna receta tendrá jamás esa dirección, así que debería responder con 404.
- En
Program.cs, cambia la ruta del endpoint de la lección anterior a/api/recipes/{id:int}. - Conserva una sola ruta para este endpoint: cambia la línea existente, no añadas una segunda.
Pruébalo: pulsa «Ejecutar»: GET /api/recipes/2 sigue respondiendo con la receta Pancakes. Envía GET /api/recipes/abc: estado 404 y cuerpo vacío. La lista de rutas muestra GET /api/recipes/{id:int}.
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.MapGet("/api/recipes/{id}", (int id) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();
Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.
Todas las lecciones de API mínimas
1Primeros endpoints
Tu primer endpointDevolver JSON2Resultados y cuerpos JSON
Correcto y no encontrado