Menu
CoddyTech

Créer avec POST

Fait partie de la section APIs REST du Journey ASP.NET Core de Coddy. Leçon 2 sur 20.

POST ajoute un élément à une collection. La requête est envoyée à l’URL de la collection, car le client ne connaît pas le nouvel identifiant : c’est le serveur qui le choisit. La réponse est 201 Created, avec le nouvel élément au format JSON et un en-tête Location qui contient l’URL du nouvel élément. Un en-tête est une ligne de texte nommée envoyée avant le corps.

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);
});

Le paramètre d’enregistrement est lu dans le corps JSON, et une propriété manquante reçoit la valeur par défaut de son type. Un compteur attribue son identifiant à chaque livre. Ne génère jamais d’identifiants avec Random ou l’horloge : les mêmes requêtes doivent toujours produire les mêmes identifiants. C’est d’autant plus important ici, car chaque clic sur « Envoyer » rejoue tes requêtes précédentes dans une nouvelle application.

challenge icon

Défi

Facile

Permets aux clients d’ajouter des tâches.

  1. Dans Program.cs, sous la liste des tâches, ajoute un compteur : var nextId = 4;
  2. En bas du fichier, sous TaskItem, déclare la structure du corps : record TaskInput(string Title, bool Done);
  3. Associe POST /api/tasks à un paramètre TaskInput input. Crée un TaskItem à partir de nextId++, input.Title et input.Done, ajoute-le à tasks, puis renvoie Results.Created($"/api/tasks/{task.Id}", task).

Le corps { "title": "Order new chairs" } renvoie le code 201 avec l’en-tête Location: /api/tasks/4 et :

{ "id": 4, "title": "Order new chairs", "done": false }

Essaie : appuie sur Exécuter, choisis POST, garde le chemin /api/tasks, saisis le corps ci-dessus et appuie sur Envoyer : tu obtiens le code 201, et l’onglet En-têtes affiche Location: /api/tasks/4. Envoie GET /api/tasks/4 : la nouvelle tâche. Envoie à nouveau le même POST : cette fois, l’identifiant est 5, car la colonne rejoue le premier POST avant celui-ci.

Essayez vous-même

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);

Toutes les leçons de APIs REST