Menu
CoddyTech

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.

challenge icon

Desafío

Fácil

GET /api/recipes aprende a filtrar: ?category=soup conserva solo las sopas.

  1. En Program.cs, dale a la lambda de GET /api/recipes un parámetro string? category.
  2. Devuelve las recetas cuyo Category sea igual a category. Cuando category sea null, 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