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.
Desafío
FácilPermite que los clientes agreguen tareas.
- En
Program.cs, debajo de la lista de tareas, agrega un contador:var nextId = 4; - Al final del archivo, debajo de
TaskItem, declara la forma del cuerpo:record TaskInput(string Title, bool Done); - Asocia
POST /api/taskscon un parámetroTaskInput input. Crea unTaskItema partir denextId++,input.Titleyinput.Done, agrégalo atasksy responde conResults.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
1Recursos y verbos
Recursos y URLCrear con POST2Validación y errores
Rechazar entradas no válidas5Navegadores y alojamiento
CORS