Menu
CoddyTech

Supprimer avec DELETE

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

DELETE supprime un élément. Lorsque l’opération réussit, la réponse est 204 No Content : l’opération a réussi, mais le corps est vide, puisqu’il n’y a plus rien à afficher. Lorsque l’élément n’existe pas, la réponse est 404.

app.MapDelete("/api/notes/{id:int}", (int id) =>
{
    var removed = notes.RemoveAll(n => n.Id == id);
    return removed == 0 ? Results.NotFound() : Results.NoContent();
});

RemoveAll renvoie le nombre d’éléments supprimés. Un id supprimé n’est jamais attribué à un nouvel élément : un client qui a conservé l’URL /api/notes/7 doit obtenir 404 par la suite, et non la note de quelqu’un d’autre. Un compteur te permet de faire cela. L’id le plus élevé plus un ne le permet pas : après la suppression de la note la plus récente, la note suivante prendrait son id.

challenge icon

Défi

Facile

Permets aux clients de supprimer une tâche.

  1. Dans Program.cs, mappe DELETE /api/tasks/{id:int}.
  2. Supprime la tâche avec tasks.RemoveAll. Si aucune tâche n’a été supprimée, réponds Results.NotFound() ; sinon, réponds Results.NoContent(), avec le statut 204 et un corps vide.
  3. Continue à attribuer les identifiants à partir de nextId : après DELETE /api/tasks/3, la prochaine nouvelle tâche reçoit l’identifiant 4, et non 3.

Essaie : appuie sur Exécuter, choisis DELETE, indique le chemin /api/tasks/3, puis appuie sur Envoyer : tu obtiens 204 et un corps vide. Envoie GET /api/tasks : il reste deux tâches. Envoie de nouveau DELETE /api/tasks/3 : tu obtiens 404, car la première suppression a déjà été effectuée. Envoie en POST { "title": "Order new chairs" } à /api/tasks : la tâche reçoit l’identifiant 4.

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),
};
var nextId = 4;

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.MapPost("/api/tasks", (TaskInput input) =>
{
    var task = new TaskItem(nextId++, input.Title, input.Done);
    tasks.Add(task);
    return Results.Created($"/api/tasks/{task.Id}", task);
});

app.MapPut("/api/tasks/{id:int}", (int id, TaskInput input) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    var task = tasks[index];
    tasks[index] = task with
    {
        Title = patch.Title ?? task.Title,
        Done = patch.Done ?? task.Done,
    };
    return Results.Ok(tasks[index]);
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
record TaskPatch(string? Title, bool? Done);

Toutes les leçons de APIs REST