Aller au contenu
Réussir mon BTS SIO

Tape une notion, une commande ou le nom d'une épreuve.

Par exemple

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

javascript
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 :

javascript
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.

Ton code

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