Cadenas de consulta
Parte de la sección API mínimas del Journey de ASP.NET Core de Coddy. Lección 5 de 20.
Una cadena de consulta es la parte de una dirección que va después de ?: pares de nombre y valor unidos por &, como en /books?author=austen&page=2. No elige la ruta; añade opciones a la solicitud. Un parámetro lambda cuyo nombre no está en la ruta se lee de la cadena de consulta.
app.MapGet("/books", (string? author, int page = 1) =>
$"Books by {author ?? "anyone"}, page {page}");GET /books?author=austen responde Books by austen, page 1. Un parámetro que admite valores nulos, como string?, o que tiene un valor predeterminado es opcional. Un string sin modificar es obligatorio: si falta, ASP.NET Core responde con 400 Bad Request y la lambda nunca se ejecuta.
Desafío
FácilGET /api/recipes aprende a filtrar: ?category=soup conserva solo las sopas.
- En
Program.cs, dale a la lambda deGET /api/recipesun parámetrostring? category. - Devuelve las recetas cuyo
Categorysea igual acategory. Cuandocategoryseanull, devuelve todas las recetas:recipes.Where(r => category is null || r.Category == category).
Pruébalo: pulsa «Ejecutar». GET /api/recipes?category=soup devuelve las dos sopas, con los ids 1 y 3. Envía GET /api/recipes: las tres recetas. Envía GET /api/recipes?category=dessert: una lista vacía, [].
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}", (int id) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();
Todas las lecciones de API mínimas
1Primeros endpoints
Tu primer endpointDevolver JSON2Resultados y cuerpos JSON
Correcto y no encontrado