Formations — 1 037 leçons en français

Accueil › Node.js › Concevoir une API REST

Concevoir une API REST — entretien Node.js

13 questions posées en entretien sur 8 sujets, avec la bonne réponse et son explication.

Ressources et URL

Que doit nommer le chemin d'une URL d'API REST ?

  1. Une ressource, au pluriel, sans verbe ✓
  2. L'action à effectuer
  3. La fonction du serveur qui traitera la requête
  4. La table de la base de données concernée

Pourquoi : Le verbe HTTP porte déjà l'action : le répéter dans le chemin produit une API qu'on ne peut pas deviner, où chaque opération invente sa forme. Nommer la table est une autre faute, plus discrète — elle lie le contrat public au schéma interne, et le moindre renommage de colonne devient un changement incompatible.

Niveau junior

Verbes HTTP

Que signifie le fait que GET soit une méthode « sûre » ?

  1. Elle ne modifie rien côté serveur, donc un intermédiaire peut la rejouer ou la mettre en cache ✓
  2. Elle est chiffrée
  3. Elle vérifie l'authentification
  4. Elle ne peut pas échouer

Pourquoi : La sûreté est une promesse faite à tout l'écosystème, pas une propriété du code : navigateurs, caches et robots d'indexation suivent les liens GET sans demander. Un GET qui supprime sera donc déclenché par un préchargement de navigateur, et l'incident sera impossible à attribuer à un utilisateur.

Niveau junior

Quelle est la différence entre PUT et PATCH ?

  1. PUT remplace la ressource entière, PATCH ne modifie que les champs envoyés ✓
  2. PUT crée, PATCH met à jour
  3. PUT est idempotent, PATCH est sûr
  4. PUT envoie du JSON, PATCH envoie du texte

Pourquoi : La conséquence pratique est qu'un PUT avec un corps partiel efface les champs omis, sans aucune erreur. Ce n'est pas un bogue du serveur mais la définition de la méthode — d'où la règle d'exposer PATCH dès qu'un client modifie un sous-ensemble de champs, faute de quoi il doit relire la ressource entière avant chaque écriture.

Niveau junior

Pagination

Pourquoi paginer une collection même quand elle est petite aujourd'hui ?

  1. Parce qu'ajouter la pagination plus tard change la forme de la réponse et casse les clients ✓
  2. Parce que HTTP limite la taille des réponses
  3. Parce que JSON ne supporte pas les grands tableaux
  4. Parce qu'Express refuse les réponses de plus de 1 Mo

Pourquoi : C'est un choix de forme, et les choix de forme ne se corrigent pas après publication : passer d'un tableau nu à un objet contenant « donnees » et « pagination » casse tous les clients existants. Le second motif est propre à Node — la sérialisation JSON est synchrone, donc une réponse énorme bloque le fil unique et toutes les autres requêtes avec elle.

Niveau junior

Quel est l'argument décisif de la pagination par curseur face à la pagination par décalage ?

  1. Une insertion pendant la lecture ne fait ni sauter ni répéter d'élément ✓
  2. Elle permet d'afficher le nombre total de pages
  3. Elle fonctionne sans index
  4. Elle évite de trier les résultats

Pourquoi : Le décalage compte des rangs, et un rang bouge dès qu'une ligne est insérée avant lui : un élément n'est jamais rendu, et personne ne s'en aperçoit puisque la réponse est parfaitement valide. Le curseur encode une valeur de clé, insensible aux insertions. Le prix est l'impossibilité de sauter à une page arbitraire, ce qui exclut cette approche d'un tableau à numéros.

Niveau confirme

Modification partielle

Dans un PATCH, comment distinguer « ne touche pas à ce champ » de « efface ce champ » ?

  1. Le champ absent du corps ne change rien, un champ explicitement à null efface ✓
  2. On utilise undefined pour effacer
  3. On envoie une chaîne vide
  4. C'est impossible, il faut utiliser PUT

Pourquoi : La convention doit être décidée et documentée, parce que JSON n'a pas de notion d'absence autre que l'absence de la clé. Côté implémentation, il faut parcourir Object.keys du corps reçu et non diffuser l'objet : une diffusion écrit aussi les clés dont la valeur est undefined, ce qui crée un troisième état qui n'est ni « absent » ni « effacé ».

Niveau confirme

Format d'erreur

Pourquoi un corps d'erreur doit-il contenir un code machine en plus du message ?

  1. Parce que sans code, les clients finissent par analyser le message, qui n'est pas stable ✓
  2. Parce que le message n'est pas transmis par les proxys
  3. Parce que le code de statut HTTP ne suffit pas à indiquer une erreur
  4. Parce que le message doit rester vide en production

Pourquoi : Un client doit distinguer « solde insuffisant » de « carte expirée », et le statut 402 ou 422 ne le dit pas. S'il n'a que du texte, il comparera du texte — et la correction d'une faute d'orthographe cassera son intégration sans qu'aucun test côté serveur ne le détecte. Le code est un contrat, le message est de la documentation en ligne.

Niveau confirme

Quelle est la conséquence la plus grave de répondre 200 avec un champ « erreur » dans le corps ?

  1. Les caches, les sondes de disponibilité et les tableaux de bord voient une réussite ✓
  2. Le corps JSON devient invalide
  3. Les clients ne peuvent plus lire le corps
  4. HTTP interdit un corps sur une réponse 200

Pourquoi : Le code de statut est la seule information que lisent les intermédiaires et l'outillage d'exploitation. Une panne annoncée en 200 donne un taux d'erreur nul sur les graphiques, une réponse d'erreur possiblement mise en cache, et des réessais qui n'ont pas lieu. L'incident existe et reste invisible — c'est pire que de se tromper entre 400 et 422.

Niveau senior

Compatibilité

Lequel de ces changements est compatible pour les clients existants ?

  1. Ajouter un paramètre de requête optionnel ✓
  2. Rendre obligatoire un paramètre qui était optionnel
  3. Renommer un champ de réponse
  4. Changer un champ de nombre en chaîne

Pourquoi : La règle tient en une phrase : les ajouts passent, les retraits et les resserrements cassent. Rendre un paramètre obligatoire est souvent cité à tort comme un ajout — c'est un resserrement, et tous les clients qui ne l'envoyaient pas reçoivent désormais une erreur. Le changement de type est le plus dangereux, car en JavaScript il ne lève rien.

Niveau confirme

Quel est le risque de sérialiser directement le résultat d'un SELECT * dans une réponse ?

  1. Chaque colonne ajoutée en base devient publique, et un contrat qu'on ne peut plus retirer ✓
  2. La réponse est plus lente à produire
  3. Les noms de colonnes ne sont pas valides en JSON
  4. Le client reçoit les types SQL au lieu des types JSON

Pourquoi : Le danger immédiat est la fuite — un hachage de mot de passe, un score interne. Le danger durable est plus coûteux : un champ publié par inadvertance finit par être lu par un client, et le retirer devient un changement incompatible qu'on n'avait jamais décidé d'assumer. La fonction de projection est exactement l'endroit où vit le contrat, et où se branche le versionnement.

Niveau senior

Tri et filtres

Pourquoi ajouter l'identifiant comme dernier critère de tri d'une collection paginée ?

  1. Pour rendre l'ordre total : deux éléments de même clé pourraient sinon s'échanger entre deux requêtes ✓
  2. Pour accélérer la requête
  3. Parce que SQL refuse un ORDER BY sur une seule colonne
  4. Pour permettre le tri décroissant

Pourquoi : Une base ne garantit aucun ordre entre lignes de clé de tri égale, et cet ordre peut changer quand le plan d'exécution change. Sans départage, des doublons et des absents apparaissent entre deux pages sans qu'aucune donnée n'ait été modifiée — un symptôme très difficile à reproduire. C'est aussi ce qui rend un curseur non ambigu : il doit encoder la clé et l'identifiant.

Niveau senior

Pourquoi un paramètre de tri doit-il passer par une table de correspondance fermée ?

  1. Parce qu'un nom de colonne ne peut pas être passé en paramètre de requête préparée, donc rien ne protège de l'injection à cet endroit ✓
  2. Parce que SQL ne permet qu'un seul ORDER BY
  3. Parce que le client ne connaît pas les noms de colonnes
  4. Parce que le tri doit être fait en mémoire

Pourquoi : La requête préparée protège les valeurs, pas les identifiants : un nom de colonne est forcément concaténé, et c'est l'un des rares endroits où l'injection reste possible dans du code par ailleurs correct. La table de correspondance règle en plus un problème de conception — elle découple les noms publics des colonnes réelles, qu'on peut alors renommer sans casser l'API.

Niveau senior

Versionnement

Quel inconvénient concret a le versionnement par en-tête face au versionnement dans l'URL ?

  1. Un client qui oublie l'en-tête reçoit silencieusement la version par défaut, et change de comportement quand ce défaut change ✓
  2. Les en-têtes ne sont pas transmis par HTTPS
  3. Il interdit de maintenir deux versions simultanément
  4. Il empêche la mise en cache des réponses

Pourquoi : L'argument de pureté joue pour l'en-tête : une ressource garde une seule URL. L'exploitabilité joue pour l'URL — version visible dans un journal, dans un lien partagé, routable vers deux déploiements. Le défaut silencieux tranche en pratique : il transforme une mise à jour de serveur en changement de comportement chez un client qui n'a rien modifié.

Niveau senior

S'entraîner sur ces questions, chronométré →