Menu
CoddyTech

Strings de consulta

Parte da seção APIs mínimas do Journey de ASP.NET Core da Coddy. Lição 5 de 20.

Uma string de consulta é a parte de um endereço depois de ?: pares de nome e valor unidos por &, como em /books?author=austen&page=2. Ela não escolhe a rota; adiciona opções à solicitação. Um parâmetro lambda cujo nome não está na rota é lido da string 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. Um parâmetro anulável, como string?, ou que tenha um valor padrão é opcional. Um string simples é obrigatório: sem ele, o ASP.NET Core responde com 400 Bad Request e a lambda nunca é executada.

challenge icon

Desafio

Fácil

GET /api/recipes aprende a filtrar: ?category=soup mantém apenas as sopas.

  1. Em Program.cs, dê à lambda de GET /api/recipes um parâmetro string? category.
  2. Retorne as receitas cuja Category seja igual a category. Quando category for null, retorne todas as receitas: recipes.Where(r => category is null || r.Category == category).

Experimente: pressione Executar. GET /api/recipes?category=soup retorna as duas sopas, ids 1 e 3. Envie GET /api/recipes: todas as três receitas. Envie GET /api/recipes?category=dessert: uma lista vazia, [].

Experimente você mesmo

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 as lições de APIs mínimas