Requête JSON
Extrayez exactement les valeurs dont vous avez besoin d'un JSON avec JSONPath.
Exemples d'utilisation
Extraire uniquement les champs nécessaires d'une grande réponse API
Plutôt que de parcourir tout le JSON de la réponse, récupérez exactement ce dont vous avez besoin d'un coup avec un chemin comme $.data.items[*].id.
Filtrer les éléments répondant à une condition
Utilisez une expression de filtre comme $.products[?(@.price<10000)] pour ne garder que les éléments répondant à une condition de prix, de stock ou autre.
Trouver une clé spécifique partout dans une structure imbriquée
La syntaxe de descente récursive, $..price, trouve chaque clé portant ce nom n'importe où dans le document, quelle que soit la profondeur ou la position.
Récupérer le dernier élément d'un tableau
Utilisez $.orders[-1:] pour extraire l'entrée la plus récente d'un tableau croissant de journaux ou de commandes sans compter combien d'éléments il contient.
Extraire plusieurs champs précis à la fois
Une expression d'union comme $.user['name','email','id'] renvoie uniquement ces trois champs d'un objet, en ignorant tout le reste d'un gros enregistrement utilisateur.
Examiner la structure d'une charge utile d'API inconnue
Vous ne savez pas à quelle profondeur un champ est imbriqué dans une réponse que vous n'avez jamais vue ? Commencez par $..fieldName pour le localiser n'importe où, puis affinez jusqu'au chemin exact une fois que vous voyez où il se trouve.
Questions fréquentes
Le JSON et l'expression que je saisis sont-ils envoyés à un serveur ?
Non. La requête s'exécute entièrement dans votre navigateur, et ce que vous saisissez n'est jamais envoyé à un serveur.
Je ne me souviens pas de la syntaxe JSONPath.
Modèles courants : $ représente tout le document, .clé une clé spécifique, [*] chaque élément d'un tableau, [0] le premier élément, [?(@.price<10)] filtre les éléments répondant à une condition, et $..clé trouve chaque clé portant ce nom à n'importe quelle profondeur.
Mon résultat est vide, pourquoi ?
Cela peut signifier que le chemin ne pointe vers aucune donnée réelle, ou que l'expression contient une erreur de syntaxe — les deux cas donnent un résultat vide. Essayez de raccourcir le chemin étape par étape pour voir où la correspondance s'arrête.
Le résultat de la requête est-il toujours un tableau ?
Oui. JSONPath rassemble chaque valeur correspondante dans un tableau, même lorsqu'une seule valeur correspond — vous obtiendrez un tableau de longueur un.
S'agit-il de la syntaxe JSONPath, JMESPath ou jq ?
JSONPath, évalué avec la bibliothèque jsonpath-plus. Elle prend en charge la syntaxe standard $, ., [*], [n] et $..key, ainsi que des extensions comme les expressions de filtre ([?(@.price<10)]) et les expressions de script — mais elle n'est pas compatible avec la syntaxe de requête de jq ou de JMESPath, qui utilisent des opérateurs différents.
Puis-je filtrer un tableau selon plus d'une condition ?
Oui — combinez les conditions avec && ou || dans une expression de filtre, par exemple $.products[?(@.price<100 && @.inStock==true)] pour retrouver les éléments à la fois bon marché et en stock.
Le chemin prend-il en charge les indices de tableau négatifs ou les tranches ?
Oui. [-1] désigne le dernier élément et la syntaxe de tranche comme [1:3] ou [-2:] fonctionne comme en Python, ce qui permet de récupérer une plage d'éléments sans connaître la longueur exacte du tableau.