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.
Desafio
FácilGET /api/recipes aprende a filtrar: ?category=soup mantém apenas as sopas.
- Em
Program.cs, dê à lambda deGET /api/recipesum parâmetrostring? category. - Retorne as receitas cuja
Categoryseja igual acategory. Quandocategoryfornull, 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
1Primeiros Endpoints
Seu primeiro EndpointRetornando JSON2Resultados e corpos JSON
OK e não encontrado