Menu
CoddyTech

Crear con POST

Parte de la sección API REST del Journey de ASP.NET Core de Coddy. Lección 2 de 20.

POST agrega un elemento a una colección. Se envía a la URL de la colección, porque el cliente no conoce el nuevo id: lo elige el servidor. La respuesta es 201 Created, con el nuevo elemento como JSON y un encabezado Location que contiene la URL del nuevo elemento. Un encabezado es una línea de texto con nombre que se envía antes del cuerpo.

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);
});

El parámetro del registro se lee del cuerpo JSON, y una propiedad ausente recibe el valor predeterminado de su tipo. Un contador asigna a cada libro su id. Nunca generes ids con Random ni con el reloj: las mismas solicitudes deben dar los mismos ids. En este caso, eso importa por partida doble, porque cada vez que pulsas «Enviar» se vuelven a ejecutar tus solicitudes anteriores en una aplicación nueva.

challenge icon

Desafío

Fácil

Permite que los clientes agreguen tareas.

  1. En Program.cs, debajo de la lista de tareas, agrega un contador: var nextId = 4;
  2. Al final del archivo, debajo de TaskItem, declara la forma del cuerpo: record TaskInput(string Title, bool Done);
  3. Asocia POST /api/tasks con un parámetro TaskInput input. Crea un TaskItem a partir de nextId++, input.Title y input.Done, agrégalo a tasks y responde con Results.Created($"/api/tasks/{task.Id}", task).

El cuerpo { "title": "Order new chairs" } responde con 201 y el encabezado Location: /api/tasks/4, además de:

{ "id": 4, "title": "Order new chairs", "done": false }

Pruébalo: pulsa Ejecutar, elige POST, deja la ruta /api/tasks, escribe el cuerpo de arriba y pulsa Enviar: 201; la pestaña Headers muestra Location: /api/tasks/4. Envía GET /api/tasks/4: la nueva tarea. Envía el mismo POST otra vez: esta recibe el id 5, porque la columna reproduce antes el primer POST.

Pruébalo tú mismo

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 las lecciones de API REST