Aller au contenu
Réussir mon BTS SIO

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

Par exemple

Exercice 6 / 6Moyen

Headers personnalisés et status appropriés

À toi

Sans Express, écris un serveur HTTP qui répond à plusieurs URLs avec des codes et headers spécifiques :

  • GET /api/articles → 200, body JSON [{ id: 1 }], headers : content-type: application/json + x-total-count: 1
  • GET /redirect → 301, header location: /api/articles, body vide
  • GET /no-content → 204, body vide, pas de content-type
  • Toute autre URL → 404, body JSON { error: "not found" }

Headers et status : choisir précisément

Status codes utiles à connaître

2xx — succès

CodeNomQuand
200OKTout va bien, body en pièce jointe
201CreatedPOST qui a créé une ressource
204No ContentSuccès sans body (DELETE typique)

3xx — redirections

CodeNomHeader obligatoireQuand
301Moved PermanentlyLocationURL changée pour de bon
302FoundLocationRedirection temporaire
304Not Modified-Cache valide (avec ETag)

4xx — erreur client

CodeNomQuand
400Bad RequestBody / params invalides
401UnauthorizedToken absent ou invalide
403ForbiddenAuth OK mais pas le droit
404Not FoundURL inconnue
405Method Not AllowedURL connue, méthode pas supportée
409ConflictConflit (ex: email déjà pris)
422UnprocessableValidation business échouée
429Too Many RequestsRate limit

5xx — erreur serveur

CodeNomQuand
500Internal Server ErrorBug, exception non gérée
502Bad GatewayService amont KO
503Service UnavailableIndisponible (maintenance, surcharge)
504Gateway TimeoutService amont a timeout

Headers — set vs writeHead

javascript
// Forme 1 : setHeader avant end
res.setHeader("content-type", "text/csv");
res.setHeader("x-export-lignes", "42");
res.statusCode = 200;
res.end(csv);

// Forme 2 : writeHead avec headers en bloc
res.writeHead(200, {
  "content-type": "text/csv",
  "x-export-lignes": "42",
});
res.end(csv);

Les deux marchent. writeHead est plus court ; setHeader permet d'ajouter des headers conditionnellement avant end.

Headers personnalisés X-

Convention historique : préfixer les headers custom par X-. Aujourd'hui la RFC 6648 recommande de ne plus mettre X-, mais l'usage perdure :

  • X-Total-Count (pagination)
  • X-Request-Id (tracing)
  • X-Forwarded-For (proxies)

En 2026 tu peux faire les deux. Garde la cohérence dans ton API.

204 No Content — particularités

Un 204 ne doit pas avoir de body. Pas de content-type non plus. Le client sait : "succès, rien à lire".

javascript
res.writeHead(204);
res.end(); // ← pas d'argument

Cas typique : DELETE /articles/7 → succès, rien à renvoyer.

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