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.
Desafío
FácilPermite que los clientes reemplacen una tarea.
- En
Program.cs, asignaPUT /api/tasks/{id:int}con un parámetroint idy otroTaskInput input. El cuerpo tiene la misma estructura que el cuerpo de una solicitud POST. - Encuentra la posición de la tarea con
tasks.FindIndex. Cuando sea -1, responde conResults.NotFound()y no añadas nada. - De lo contrario, guarda
new TaskItem(id, input.Title, input.Done)en esa posición y responde conResults.Ok.PUT /api/tasks/1con{ "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
1Recursos y verbos
Recursos y URLCrear con POST2Validación y errores
Rechazar entradas no válidas5Navegadores y alojamiento
CORS