Menu
CoddyTech

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.

challenge icon

Desafío

Fácil

GET /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.

  1. En Program.cs, cambia la ruta del endpoint de la lección anterior a /api/recipes/{id:int}.
  2. 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();
quiz iconPonte a prueba

Esta lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.

Todas las lecciones de API mínimas