Le routage

Une API qui renvoie 200 OK avec un corps { "erreur": "utilisateur introuvable" } casse tout ce qui la consomme. Le client HTTP ne déclenche pas son chemin d'erreur, le cache intermédiaire mémorise la réponse, la supervision compte une requête réussie, et l'incident ne remonte que lorsqu'un humain lit un écran vide. Le code de retour n'est pas de la décoration : c'est la seule partie de votre réponse que comprennent les proxys, les caches, les navigateurs et les bibliothèques clientes.

Le second problème classique du routage est structurel. Toutes les routes déclarées à la suite dans un même fichier finissent par se marcher dessus : /utilisateurs/moi est capturée par /utilisateurs/:id déclarée plus haut, et l'on passe une heure à chercher pourquoi le handler reçoit id === 'moi'. Express évalue les routes dans l'ordre de déclaration, sans notion de spécificité. Cette leçon traite les deux sujets ensemble, parce qu'un routage bien découpé est aussi un routage dont l'ordre reste maîtrisable.

Paramètres, requête, corps

Trois sources d'entrée, trois usages distincts.