Naviguer dans le JSON d’une API avec Raccourcis
Comment naviguer dans un objet JSON complexe retourné par une API, comme celle de WordPress. L’objectif est simple : récupérer une information précise, en l’occurrence l’URL d’une miniature d’image, qui est imbriquée dans plusieurs niveaux de données. Une simple syntaxe à points permet d’atteindre directement la valeur souhaitée.
Lorsque je travaille avec des API, comme l’API REST de WordPress, je reçois souvent des réponses structurées en JSON. Mon besoin du jour est de récupérer l’URL de la miniature (thumbnail) d’une image spécifique hébergée sur un site WordPress. Le problème, c’est que cette information n’est pas disponible au premier niveau de l’objet JSON retourné.
L’URL que je cherche est en fait “embeddée”, c’est-à-dire qu’elle se trouve à l’intérieur d’un objet, qui est lui-même contenu dans un autre objet. Il faut donc trouver un moyen efficace de traverser cette arborescence de données pour accéder directement à la valeur dont j’ai besoin.
Autrement dit, les API retournent souvent des données JSON structurées sur plusieurs niveaux. L’information que vous cherchez n’est pas toujours accessible directement et nécessite une navigation à travers l’objet.
La solution : la notation par points pour la navigation
Face à une structure JSON où les données sont imbriquées, la solution la plus simple et la plus lisible est d’utiliser la notation par points. Plutôt que d’accéder à chaque dictionnaire intermédiaire un par un, cette syntaxe me permet de définir un chemin direct vers la valeur finale.
Comment construire le chemin d’accès ?
Pour obtenir l’URL de ma miniature, je vais simplement enchaîner les noms des clés (les “objets” ou “dictionnaires”) qui mènent à ma cible, en les séparant par des points. Dans le cas de l’API WordPress, le chemin pour accéder à l’URL source de la miniature est le suivant : mediadetails.sizes.thumbnail.sourceurl.
Appliquer la méthode
Concrètement, au lieu de demander la valeur pour une seule clé, je vais utiliser l’action « Obtenir valeur » en lui passant ce chemin complet. La commande ressemblera donc à ceci : Obtenir Valeur pour mediadetails.sizes.thumbnail.sourceurl dans Dictionnaire (l’objet JSON principal retourné par l’API). Cette approche me donne directement l’URL recherchée, sans code superflu.
À retenir, donc : La syntaxe objet1.objet2.cleFinale permet de traverser un JSON imbriqué pour récupérer une valeur précise. C’est une méthode propre, lisible et efficace.
