Menu
CoddyTech

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.

challenge icon

Sfida

Facile

Consenti ai client di aggiungere attività.

  1. In Program.cs, sotto l'elenco delle attività, aggiungi un contatore: var nextId = 4;
  2. In fondo al file, sotto TaskItem, dichiara la struttura del corpo: record TaskInput(string Title, bool Done);
  3. Mappa POST /api/tasks con un parametro TaskInput input. Crea un TaskItem usando nextId++, input.Title e input.Done, aggiungilo a tasks e restituisci Results.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