Remplacer avec PUT

Fait partie de la section API REST du Journey Node.js de Coddy. Leçon 5 sur 18.

Un formulaire de modification renvoie la tâche entière, avec tous les champs à la fois. PUT signifie « remplacer la ressource par ceci », donc le corps doit être complet.

PATCH /api/invoices/7  { "paid": true }               → paid changes
PUT   /api/invoices/7  { "amount": 90, "paid": true } → a new invoice 7
PUT   /api/invoices/7  { "paid": true }               → 400: amount missing

Un PUT auquel il manque un champ renvoie 400 : remplacer par une facture incomplète ferait perdre le montant. Les champs gérés par le serveur, comme l’id et l’heure de création, proviennent de l’ancienne version, jamais du corps :

const { id, issuedAt } = invoices[index];
invoices[index] = { id, amount, paid, issuedAt };

Défi

Facile

PUT /api/tasks/:id remplace title et done par les valeurs du corps de la requête et renvoie la tâche avec le code 200.
id et createdAt restent inchangés.
Si title ou done manque : 400. Si l’identifiant est inconnu : 404.

Envoyez PUT /api/tasks/2 avec { "title": "Book the big room", "done": true }, puis avec { "done": true }.

Essayez vous-même

import { Router } from 'express';
import { nextId, tasks } from '../store.js';

const router = Router();

router.get('/', (req, res) => {
    res.json(tasks);
});

router.get('/:id', (req, res) => {
    const task = tasks.find((t) => t.id === Number(req.params.id));
    if (!task) {
        return res.status(404).json({ error: 'Task not found' });
    }
    res.json(task);
});

router.post('/', (req, res) => {
    const { title } = req.body ?? {};
    if (!title) {
        return res.status(400).json({ error: 'title is required' });
    }
    const task = { id: nextId(), title, done: false, createdAt: new Date().toISOString() };
    tasks.push(task);
    res.status(201).location(`/api/tasks/${task.id}`).json(task);
});

router.patch('/:id', (req, res) => {
    const task = tasks.find((t) => t.id === Number(req.params.id));
    if (!task) {
        return res.status(404).json({ error: 'Task not found' });
    }
    const { title, done } = req.body ?? {};
    if (title !== undefined) task.title = title;
    if (done !== undefined) task.done = done;
    res.json(task);
});

router.delete('/:id', (req, res) => {
    const index = tasks.findIndex((t) => t.id === Number(req.params.id));
    if (index === -1) {
        return res.status(404).json({ error: 'Task not found' });
    }
    tasks.splice(index, 1);
    res.status(204).end();
});

export default router;