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.
Défi
FacilePermets aux clients d’ajouter des tâches.
- Dans
Program.cs, sous la liste des tâches, ajoute un compteur :var nextId = 4; - En bas du fichier, sous
TaskItem, déclare la structure du corps :record TaskInput(string Title, bool Done); - Associe
POST /api/tasksà un paramètreTaskInput input. Crée unTaskItemà partir denextId++,input.Titleetinput.Done, ajoute-le àtasks, puis renvoieResults.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
1Ressources et verbes
Ressources et URLCréer avec POST2Validation et erreurs
Rejeter les entrées incorrectes