Criando com POST
Parte da seção APIs REST do Journey de ASP.NET Core da Coddy. Lição 2 de 20.
POST adiciona um item a uma coleção. Ele vai para a URL da coleção, porque o cliente não conhece o novo id: o servidor o escolhe. A resposta é 201 Created, com o novo item em JSON e um cabeçalho Location que contém a URL do novo item. Um cabeçalho é uma linha de texto nomeada enviada antes do corpo.
var nextId = 8;
app.MapPost("/api/books", (BookInput input) =>
{
var book = new Book(nextId++, input.Title, input.Author);
books.Add(book);
return Results.Created($"/api/books/{book.Id}", book);
});O parâmetro do registro é lido do corpo JSON, e uma propriedade ausente recebe o valor padrão de seu tipo. Um contador atribui um id a cada livro. Nunca gere ids com Random ou com o relógio: as mesmas solicitações devem gerar os mesmos ids. Isso importa ainda mais aqui, porque cada ação de Enviar reproduz suas solicitações anteriores em um app novo.
Desafio
FácilPermita que os clientes adicionem tarefas.
- Em
Program.cs, abaixo da lista de tarefas, adicione um contador:var nextId = 4; - No fim do arquivo, abaixo de
TaskItem, declare o formato do corpo:record TaskInput(string Title, bool Done); - Mapeie
POST /api/taskscom um parâmetroTaskInput input. Crie umTaskItemusandonextId++,input.Titleeinput.Done, adicione-o ataskse retorneResults.Created($"/api/tasks/{task.Id}", task).
O corpo { "title": "Order new chairs" } retorna 201 com o cabeçalho Location: /api/tasks/4 e:
{ "id": 4, "title": "Order new chairs", "done": false }Experimente: pressione Executar, escolha POST, mantenha o caminho /api/tasks, digite o corpo acima e clique em Enviar: 201; a aba Headers mostra Location: /api/tasks/4. Envie GET /api/tasks/4: a nova tarefa. Envie o mesmo POST novamente: esta tarefa recebe o id 5, porque a coluna repete o primeiro POST antes dela.
Experimente você mesmo
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var tasks = new List<TaskItem>
{
new(1, "Write the project brief", false),
new(2, "Book the meeting room", true),
new(3, "Send the invoice", false),
};
app.MapGet("/api/tasks", () => tasks);
app.MapGet("/api/tasks/{id:int}", (int id) =>
{
var task = tasks.Find(t => t.Id == id);
return task is null ? Results.NotFound() : Results.Ok(task);
});
app.Run();
record TaskItem(int Id, string Title, bool Done);
Todas as lições de APIs REST
1Recursos e verbos
Recursos e URLsCriando com POST