Accueil › Node.js › Choisir le statut et les en-têtes
Choisir le statut et les en-têtes
Exercice de la série « Un serveur HTTP sans framework »intermediaire
Le besoin. Un gestionnaire décide d'un résultat métier ; la couche HTTP
le traduit en statut, en-têtes et corps. Cette traduction est le dernier
endroit où une API se révèle soignée ou bâclée : un 201 sans Location,
un 204 avec un corps, un 403 qui révèle l'existence d'une ressource sont
les trois reproches les plus fréquents faits aux API maison.
Ce qu'on vous demande. Écrivez repondre(resultat) où resultat.sorte
vaut l'une des valeurs ci-dessous. Renvoyez { statut, entetes, corps },
corps valant null quand il n'y en a pas. Toute réponse avec corps
porte l'en-tête "content-type": "application/json; charset=utf-8" ; une
réponse sans corps ne porte aucun en-tête, sauf mention contraire.
sorte |
Statut | En-têtes et corps |
|---|---|---|
"cree" |
201 |
location égal à resultat.chemin, corps resultat.corps |
"supprime" |
204 |
aucun en-tête, corps: null |
"invalide" |
422 |
corps { erreurs: resultat.champs } |
"conflit" |
409 |
corps { erreur: resultat.message } |
"absent" |
404 |
corps { erreur: "introuvable" } |
"interdit" |
403, ou 404 si resultat.secret |
corps { erreur: "interdit" }, ou { erreur: "introuvable" } |
"trop-de-requetes" |
429 |
retry-after égal à resultat.apres en chaîne, corps { erreur: "trop de requêtes" } |
Le piège. Le secret. Un 403 sur /factures/4182 confirme que cette
facture existe, ce qui permet d'énumérer les identifiants d'un service
entier sans jamais lire un contenu. Quand l'existence est elle-même
confidentielle, la réponse juste est un 404 indiscernable de celle
d'une ressource absente — corps compris. Un 403 dont le corps dit
« introuvable » ne trompe personne.
Cas de test
[{"sorte":"cree","chemin":"/articles/42","corps":{"id":42,"titre":"Flux"}}][{"sorte":"supprime"}][{"sorte":"invalide","champs":{"age":"doit être un nombre"}}][{"sorte":"conflit","message":"courriel déjà utilisé"}][{"sorte":"absent"}][{"sorte":"interdit","secret":false}]
Votre code s'exécute réellement dans le navigateur, et la correction compare son résultat à celui d'une solution de référence.