Menu
CoddyTech

Reemplazar con PUT

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

PUT reemplaza un elemento. El cuerpo contiene el estado nuevo completo del elemento, se envía a la URL propia del elemento y cualquier campo que el cuerpo omita recibe su valor predeterminado. Enviar el mismo PUT dos veces da el mismo resultado, por lo que PUT es idempotente: un cliente puede volver a intentarlo después de un tiempo de espera. POST no lo es, ya que un segundo POST agrega un segundo elemento.

app.MapPut("/api/products/{id:int}", (int id, ProductInput input) =>
{
    var index = products.FindIndex(p => p.Id == id);
    if (index == -1) return Results.NotFound();
    products[index] = new Product(id, input.Name, input.Price);
    return Results.Ok(products[index]);
});

El id proviene de la ruta, nunca del cuerpo, por lo que un cliente no puede cambiar el id de un producto. FindIndex devuelve la posición del elemento en la lista, o -1 cuando no hay ninguna coincidencia, y products[index] = ... guarda la nueva versión en su lugar.

challenge icon

Desafío

Fácil

Permite que los clientes reemplacen una tarea.

  1. En Program.cs, asigna PUT /api/tasks/{id:int} con un parámetro int id y otro TaskInput input. El cuerpo tiene la misma estructura que el cuerpo de una solicitud POST.
  2. Encuentra la posición de la tarea con tasks.FindIndex. Cuando sea -1, responde con Results.NotFound() y no añadas nada.
  3. De lo contrario, guarda new TaskItem(id, input.Title, input.Done) en esa posición y responde con Results.Ok. PUT /api/tasks/1 con { "title": "Write the final brief", "done": true } responde 200 y:
    { "id": 1, "title": "Write the final brief", "done": true }

Pruébalo: pulsa Ejecutar, elige PUT, la ruta /api/tasks/1, el cuerpo de arriba y Enviar: obtendrás 200 y la tarea de arriba. Envía GET /api/tasks/1: verás el nuevo título. Envía PUT /api/tasks/2 con { "title": "Book the big room" }: la tarea 2 estaba marcada como completada, pero el cuerpo no incluía done, así que la respuesta será "done": false. Una solicitud PUT a /api/tasks/99 responde 404.

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),
};
var nextId = 4;

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.MapPost("/api/tasks", (TaskInput input) =>
{
    var task = new TaskItem(nextId++, input.Title, input.Done);
    tasks.Add(task);
    return Results.Created($"/api/tasks/{task.Id}", task);
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);

Todas las lecciones de API REST