Aplatir un JSON imbriqué en tableau avec des clés à points

Chaque propriété imbriquée reçoit un chemin en notation pointée et les positions des tableaux deviennent des segments numériques : un identifiant de commande est ainsi toujours accessible sous orders.0.id. Le résultat convient aux feuilles de calcul, tables de préparation de bases de données, journaux, outils de mappage et à tout flux exigeant des chemins prévisibles plutôt que des structures imbriquées. Le traitement est déterministe, conserve les types JSON et rejette clairement le JSON mal formé ou une racine scalaire.

Convertissez une structure imbriquée en chemins prévisibles

Le JSON imbriqué convient parfaitement aux API, car il regroupe les valeurs associées, mais de nombreux outils de rapport et d’importation attendent une suite de champs à plat. Cette capacité parcourt chaque propriété d’objet et chaque élément de tableau, puis relie les segments par un point. Une valeur placée dans un objet customer, sous une propriété name, devient customer.name. Le premier élément d’un tableau orders est désigné par orders.0 ; son identifiant devient donc orders.0.id. Chaque feuille est renvoyée sous forme de ligne comprenant une clé et une valeur, ce qui facilite l’affichage, le filtrage ou la conversion en colonnes. Le parcours respecte l’ordre du JSON analysé et donne un résultat stable pour une même entrée. Les chaînes, nombres et booléens gardent leur type, tout comme null. Les objets et tableaux vides sont émis comme valeurs au lieu de disparaître silencieusement : la sortie aplatie indique ainsi que ces chemins existaient bien dans le document source.

Préparez l’entrée et interprétez la sortie

Fournissez le document JSON complet sous forme de texte dans le champ json. Sa racine doit être un objet ou un tableau. Cette exigence évite une clé vide ambiguë pour une chaîne, un nombre, un booléen ou null isolé. Les noms de propriétés sont repris exactement, tandis que les indices de tableau deviennent des segments numériques commençant à zéro. La réponse contient pairs, un tableau dont chaque entrée possède les champs key et value, directement exploitable comme lignes tabulaires. Si la racine est elle-même un objet ou tableau vide, la clé renvoyée est une chaîne vide et la valeur conserve ce conteneur. Sachez que les points déjà présents dans le nom d’une propriété source ne sont pas échappés. Ainsi, une propriété littérale user.name produit le même chemin visible qu’un objet user imbriqué contenant name. Si vos données emploient de tels noms et que les chemins doivent être réversibles, renommez ces propriétés avant l’aplatissement ou conservez le JSON original avec le résultat.

Exploitez les paires aplaties dans vos flux de données

Les paires aplaties constituent une représentation intermédiaire pratique. Une automatisation de feuille de calcul peut placer les clés dans une colonne et les valeurs dans une autre ; une tâche d’ingestion peut faire pivoter certains chemins en colonnes d’une ligne large ; un comparateur peut indexer les paires par clé avant d’examiner deux documents. Les segments numériques des tableaux distinguent aussi clairement les enregistrements répétés au lieu de mélanger leurs valeurs. Comme l’opération n’effectue aucune requête réseau et n’utilise ni valeur aléatoire, ni horodatage, ni inférence de modèle, un texte JSON identique produit toujours la même sortie. Un JSON non valide échoue sans résultat partiel ; un JSON scalaire valide échoue aussi, car il ne respecte pas le contrat objet-ou-tableau. Le tarif de l’API est de $0.002 par élément, tandis que l’exécuteur du navigateur applique gratuitement la même logique déterministe en local. Pour un document immense, envisagez plutôt un pipeline diffusé ou adapté au schéma, car l’aplatissement crée une ligne pour chaque feuille primitive ou conteneur vide.