Creare con POST
Fa parte della sezione API REST del percorso ASP.NET Core di Coddy. Lezione 2 di 20.
POST aggiunge un elemento a una raccolta. La richiesta viene inviata all'URL della raccolta, perché il client non conosce il nuovo id: lo sceglie il server. La risposta è 201 Created, con il nuovo elemento in formato JSON e un'intestazione Location che contiene l'URL del nuovo elemento. Un'intestazione è una riga di testo con un nome, inviata prima del 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);
});Il parametro del record viene letto dal corpo JSON e una proprietà mancante riceve il valore predefinito del suo tipo. Un contatore assegna a ogni libro il suo id. Non creare mai id usando Random o l'orologio: le stesse richieste devono produrre gli stessi id. In questo caso è importante per due motivi, perché ogni pressione di «Invia» ripete le richieste precedenti su una nuova app.
Sfida
FacileConsenti ai client di aggiungere attività.
- In
Program.cs, sotto l'elenco delle attività, aggiungi un contatore:var nextId = 4; - In fondo al file, sotto
TaskItem, dichiara la struttura del corpo:record TaskInput(string Title, bool Done); - Mappa
POST /api/taskscon un parametroTaskInput input. Crea unTaskItemusandonextId++,input.Titleeinput.Done, aggiungilo ataskse restituisciResults.Created($"/api/tasks/{task.Id}", task).
Il corpo { "title": "Order new chairs" } restituisce 201 con l'header Location: /api/tasks/4 e:
{ "id": 4, "title": "Order new chairs", "done": false }Prova: premi Esegui, seleziona POST, lascia il percorso /api/tasks, inserisci il corpo qui sopra e premi Invia: 201, e la scheda Headers mostra Location: /api/tasks/4. Invia GET /api/tasks/4: la nuova attività. Invia di nuovo lo stesso POST: questa volta ottiene l'id 5, perché la colonna riproduce prima il primo POST.
Provalo tu
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);
Tutte le lezioni di API REST
1Risorse e verbi
Risorse e URLCreare con POST2Validazione ed errori
Rifiutare input non validi