Exercice 5 / 8Facile
Préfixer ses routes (/api/v1)
À toi
Crée trois routes toutes préfixées par /api/v1 :
GET /api/v1/users→ renvoie[{ id: 1, prenom: "Léa" }]GET /api/v1/articles→ renvoie[]GET /api/v1/health→ renvoie{ ok: true }
Pour les bonus points, factorise le préfixe (mais ce n'est pas obligatoire pour passer les tests).
Préfixer ses routes : /api/v1
En production tu vas typiquement servir :
- ton frontend sur
/(HTML) - ton API sur un préfixe, par exemple
/catalogue/v2/...
Et v2 te permet de versionner ton API : si tu changes le format des réponses dans 6 mois, tu sors une v3 sans casser les clients qui consomment encore v2.
Méthode 1 — recopier le préfixe
app.get("/catalogue/v2/produits", (req, res) => res.json([]));
app.get("/catalogue/v2/categories", (req, res) => res.json(["livres"]));
app.get("/catalogue/v2/statut", (req, res) => res.json({ enLigne: true }));
Ça marche, mais c'est répétitif. Si tu veux passer à v3, il faut modifier chaque ligne.
Méthode 2 — express.Router
express.Router() crée un mini-app que tu peux monter sur un préfixe :
const express = require("express");
const app = express();
const catalogueV2 = express.Router();
catalogueV2.get("/produits", (req, res) => res.json([]));
catalogueV2.get("/categories", (req, res) => res.json(["livres"]));
catalogueV2.get("/statut", (req, res) => res.json({ enLigne: true }));
app.use("/catalogue/v2", catalogueV2);
module.exports = app;
Pour passer à v3, une seule ligne à changer : app.use("/catalogue/v3", catalogueV2).
📖 Définition Un router est un objet qui regroupe des routes liées (par exemple toutes les routes
users/). Il est ensuite monté à un préfixe sur l'app principale. C'est la fondation du pattern MVC qu'on verra au module 15.
Versioning — pourquoi v1 ?
Imagine que ton API renvoie { name: "Léa" } en v1. Six mois plus tard tu veux passer à { firstName: "Léa", lastName: "..." }. Si tu modifies l'endpoint existant, toutes les apps qui l'utilisent cassent.
À la place : tu sors v2 avec le nouveau format, tu maintiens v1 quelques mois en parallèle, tu préviens tes consommateurs. Migration en douceur.
Tu es bloqué ?
Ouvre les indices un par un, le corrigé en dernier.
Indice 1
Méthode simple : recopie /api/v1 dans chaque app.get(...).
Indice 2
Méthode propre : crée un router = express.Router(), déclare les routes dessus, puis app.use("/api/v1", router).
Indice 3
Le versioning d'API (v1, v2…) permet de faire évoluer ton API sans casser les clients existants.
Voir le corrigé
Connecte-toi pour voir le corrigé
C'est gratuit, avec ton compte Google : un clic, et tu reviens ici. Ta progression te suit ensuite sur tous tes appareils.
Le site garde ton nom et ton email, rien d'autre. Tes données
Pour revoir la notion : chapitre 3 du cours Node.js, Express.js : créer un serveur et des routes.
Connecte-toi pour faire cet exercice
C'est gratuit, avec ton compte Google : un clic, et tu reviens ici. Ta progression te suit ensuite sur tous tes appareils.
Le site garde ton nom et ton email, rien d'autre. Tes données