OK e não encontrado
Parte da seção APIs mínimas do Journey de ASP.NET Core da Coddy. Lição 6 de 20.
Um endpoint que pode responder de mais de uma maneira retorna um resultado de Results, que define o código de status. Results.Ok(value) é 200 com o valor em JSON, e Results.NotFound() é 404 Not Found, o código para algo que não existe.
app.MapGet("/books/{id:int}", (int id) =>
{
var book = books.FirstOrDefault(b => b.Id == id);
if (book is null)
return Results.NotFound(new { error = "No such book" });
return Results.Ok(book);
});Todo return passa por Results, então eles compartilham um único tipo, IResult, e a expressão lambda compila. new { error = "No such book" } é um objeto anônimo: o ASP.NET Core o escreve como {"error":"No such book"}, um corpo que informa ao cliente o que deu errado.
Desafio
FácilGET /api/recipes/99 responde com 200 e null. Um cliente não consegue distinguir isso de uma receita que existe, então a resposta deve ser 404.
- Em
Program.cs, dê à lambdaGET /api/recipes/{id:int}um corpo em bloco,{ ... }, que encontra a receita comFirstOrDefault. - Quando ela for
null, retorneResults.NotFound(new { error = $"Recipe {id} not found" }). Para o id 99, o corpo é{"error":"Recipe 99 not found"}. - Caso contrário, retorne
Results.Ok(recipe).
Experimente: pressione Executar. GET /api/recipes/99 responde com o status 404 e {"error":"Recipe 99 not found"}. Envie GET /api/recipes/2: status 200 e a receita de Pancakes, como antes.
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", (string? category) =>
recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) => recipes.FirstOrDefault(r => r.Id == id));
app.Run();
Todas as lições de APIs mínimas
2Resultados e corpos JSON
OK e não encontrado