Menu
CoddyTech

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.

challenge icon

Desafio

Fácil

Permita que os clientes adicionem tarefas.

  1. Em Program.cs, abaixo da lista de tarefas, adicione um contador: var nextId = 4;
  2. No fim do arquivo, abaixo de TaskItem, declare o formato do corpo: record TaskInput(string Title, bool Done);
  3. Mapeie POST /api/tasks com um parâmetro TaskInput input. Crie um TaskItem usando nextId++, input.Title e input.Done, adicione-o a tasks e retorne Results.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