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: 1GET /redirect→301, headerlocation: /api/articles, body videGET /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
| Code | Nom | Quand |
|---|---|---|
| 200 | OK | Tout va bien, body en pièce jointe |
| 201 | Created | POST qui a créé une ressource |
| 204 | No Content | Succès sans body (DELETE typique) |
3xx — redirections
| Code | Nom | Header obligatoire | Quand |
|---|---|---|---|
| 301 | Moved Permanently | Location | URL changée pour de bon |
| 302 | Found | Location | Redirection temporaire |
| 304 | Not Modified | - | Cache valide (avec ETag) |
4xx — erreur client
| Code | Nom | Quand |
|---|---|---|
| 400 | Bad Request | Body / params invalides |
| 401 | Unauthorized | Token absent ou invalide |
| 403 | Forbidden | Auth OK mais pas le droit |
| 404 | Not Found | URL inconnue |
| 405 | Method Not Allowed | URL connue, méthode pas supportée |
| 409 | Conflict | Conflit (ex: email déjà pris) |
| 422 | Unprocessable | Validation business échouée |
| 429 | Too Many Requests | Rate limit |
5xx — erreur serveur
| Code | Nom | Quand |
|---|---|---|
| 500 | Internal Server Error | Bug, exception non gérée |
| 502 | Bad Gateway | Service amont KO |
| 503 | Service Unavailable | Indisponible (maintenance, surcharge) |
| 504 | Gateway Timeout | Service amont a timeout |
Headers — set vs writeHead
// 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".
res.writeHead(204);
res.end(); // ← pas d'argument
Cas typique : DELETE /articles/7 → succès, rien à renvoyer.
Tu es bloqué ?
Ouvre les indices un par un, le corrigé en dernier.
Indice 1
res.setHeader("x-total-count", "1"); AVANT res.writeHead ou avec writeHead second arg.
Indice 2
Pour 204 : res.statusCode = 204; res.end(); — pas de body, pas de content-type.
Indice 3
Le header Location est ce qui dit au navigateur où aller pour une redirection.
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 2 du cours API REST, Le protocole HTTP : requête, réponse, méthodes et en-têtes.
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