Menu
CoddyTech

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.

challenge icon

Desafio

Fácil

GET /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.

  1. Em Program.cs, dê à lambda GET /api/recipes/{id:int} um corpo em bloco, { ... }, que encontra a receita com FirstOrDefault.
  2. Quando ela for null, retorne Results.NotFound(new { error = $"Recipe {id} not found" }). Para o id 99, o corpo é {"error":"Recipe 99 not found"}.
  3. 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