DifficileChoix multiples

Question d'entraînement 200-901

Quelles sont les DEUX affirmations concernant les bonnes pratiques de conception d'API REST qui sont correctes ?

Choisissez toutes les bonnes réponses.

Bonnes réponses

  • CLes ressources doivent être représentées en utilisant des noms dans l'URI
  • ELes verbes HTTP doivent décrire l'action effectuée sur la ressource

Explication

L'option C est correcte car les bonnes pratiques de REST dictent que les URI identifient des ressources, et non des actions, elles doivent donc utiliser des noms (par exemple, /users/123) plutôt que des verbes comme /getUser. L'option E est correcte car dans REST, la méthode HTTP elle-même transmet l'action sur la ressource — GET récupère, POST crée, PUT remplace, PATCH met à jour partiellement et DELETE supprime — ce qui maintient l'URI sans action. L'option A est incorrecte car le versionnement s'effectue généralement via le chemin de l'URI (par exemple, /v1/users), des types de médias personnalisés ou des en-têtes, et non uniquement via des paramètres de requête. L'option B est incorrecte car PUT est conçu pour le remplacement complet d'une ressource, tandis que PATCH est la méthode correcte pour les mises à jour partielles. L'option D est incorrecte car les réponses REST incluent généralement une représentation (JSON/XML) dans le corps ainsi que le code d'état, et non un simple code d'état brut.

Pourquoi chaque option est juste ou fausse

A

Fausse

Le versionnement de l'API doit être implémenté en utilisant uniquement des paramètres de requête

Le versionnement par paramètres de requête pollue les identifiants de ressources et complique la mise en cache et le routage ; le versionnement par chemin URI ou type de média est standard. C'est tentant car les chaînes de requête sont rapides à ajouter et conviendraient à des paramètres de filtrage ou de pagination plutôt qu'à la négociation de version d'API.

B

Fausse

La méthode HTTP PUT doit être utilisée pour les mises à jour partielles d'une ressource

PUT remplace l'intégralité de la représentation de la ressource, de sorte que les champs omis sont écrasés ; les mises à jour partielles relèvent de PATCH. C'est tentant car PUT est familier et idempotent, et serait correct lorsqu'un client envoie une représentation de remplacement complète de la ressource.

C

Juste

Les ressources doivent être représentées en utilisant des noms dans l'URI

REST traite tout comme une ressource, de sorte que les URI doivent nommer ces ressources avec des noms (par exemple, /orders/42) plutôt que des verbes ou des actions. La méthode HTTP transmet ensuite l'opération, maintenant l'interface uniforme et prévisible.

D

Fausse

Les réponses doivent renvoyer uniquement des codes d'état HTTP sans corps

Les codes d'état seuls ne donnent aux clients aucune représentation de la ressource créée ou mise à jour, brisant le contrat orienté ressource de REST. C'est tentant car les codes sont compacts et peuvent être mis en cache, et conviendraient à des points de terminaison tels que DELETE ou des réponses 204 No Content où aucune entité n'est renvoyée.

E

Juste

Les verbes HTTP doivent décrire l'action effectuée sur la ressource

Les verbes HTTP portent la sémantique de l'opération : GET récupère, POST crée, PUT remplace et DELETE supprime. Encoder l'action dans la méthode plutôt que dans l'URI permet de garder les ressources adressables par nom et préserve un comportement uniforme et mis en cache.

Pour aller plus loin

REST traite tout comme une ressource identifiée par un URI, de sorte que les chemins doivent utiliser des noms au pluriel (par exemple, /orders/42) plutôt que des verbes comme /getOrder, permettant à la méthode HTTP de transmettre l'opération : GET récupère, POST crée, PUT remplace, PATCH met à jour partiellement, DELETE supprime. Cette séparation permet la mise en cache, des garanties d'idempotence et des intermédiaires uniformes. Une subtilité importante est que PUT est défini comme un remplacement complet, donc l'utiliser pour des mises à jour partielles peut effacer silencieusement les champs omis, ce qui explique l'existence de PATCH. Dans une intégration réelle, un client envoyant PUT avec uniquement un champ d'e-mail modifié pourrait effacer le nom et l'adresse de l'utilisateur, tandis qu'un PATCH /users/42 correctement conçu avec un corps partiel ne met à jour que les attributs fournis.

À propos de ces questions d'entraînement

Cette question fait partie des questions d'entraînement 200-901 originales de Courseiva, rédigées pour apprendre et jamais copiées d'examens réels ou de dumps.

Traduite de l'original anglais avec l'IA et vérifiée pour le sens. Les codes d'examen, les commandes et les noms de produits sont conservés tels qu'ils apparaissent à l'examen.