Menu
CoddyTech

Lendo um corpo JSON

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

Uma solicitação POST envia dados em seu corpo, geralmente como JSON. Quando uma lambda POST recebe um parâmetro de registro, o ASP.NET Core lê o corpo como JSON e o associa a esse parâmetro, independentemente de maiúsculas e minúsculas nos nomes.

app.MapPost("/notes", (NewNote input) =>
{
    var note = new Note(notes.Count + 1, input.Text);
    notes.Add(note);
    return Results.Created($"/notes/{note.Id}", note);
});

Results.Created responde com 201 Created, o status de um novo recurso, com um cabeçalho Location contendo seu endereço e o recurso no corpo. Um valor do tipo errado, como "text": 5, resulta em 400 antes de a lambda ser executada. Uma propriedade que o JSON não inclui recebe seu valor padrão: null ou 0. Em um laptop, o curl envia um corpo com -d; aqui, a barra de solicitação tem uma caixa Body.

challenge icon

Desafio

Fácil

Os clientes podem adicionar receitas. Eles enviam tudo, menos o id, e a API escolhe o próximo id.

  1. Em Recipe.cs, adicione record NewRecipe(string Name, string Category, int Minutes);.
  2. Em Program.cs, abaixo da lista, adicione var nextId = 4;.
  3. Mapeie POST /api/recipes. A lambda recebe NewRecipe input, cria new Recipe(nextId++, input.Name, input.Category, input.Minutes) e o adiciona a recipes.
  4. Retorne Results.Created($"/api/recipes/{recipe.Id}", recipe).

Experimente: pressione Executar, selecione POST, digite o caminho /api/recipes e o corpo {"name":"Waffles","category":"breakfast","minutes":20}, depois Enviar. A resposta é o status 201 com {"id":4,"name":"Waffles","category":"breakfast","minutes":20}, e a guia Cabeçalhos mostra Location: /api/recipes/4. Envie GET /api/recipes/4: Waffles. Cada vez que você pressiona Enviar, os POSTs anteriores são reproduzidos em um app novo, então a receita continua lá. Envie o POST novamente: id 5.

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) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    return Results.Ok(recipe);
});

app.Run();
quiz iconTeste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de APIs mínimas