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.
Desafio
FácilOs clientes podem adicionar receitas. Eles enviam tudo, menos o id, e a API escolhe o próximo id.
- Em
Recipe.cs, adicionerecord NewRecipe(string Name, string Category, int Minutes);. - Em
Program.cs, abaixo da lista, adicionevar nextId = 4;. - Mapeie
POST /api/recipes. A lambda recebeNewRecipe input, crianew Recipe(nextId++, input.Name, input.Category, input.Minutes)e o adiciona arecipes. - 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();
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
2Resultados e corpos JSON
OK e não encontrado