Quelqu’un vous a envoyé une réponse d’API et quelqu’un d’autre la veut dans un tableur. C’est tout le travail — et c’est plus difficile qu’il n’y paraît, car le JSON est un arbre et un tableur une grille. Cette page prend les trois décisions qui transforment l’un en l’autre, et vous montre ce qu’elle a décidé.

Comment l’utiliser

1. 1 Collez le JSON, ou déposez un fichier .json.
2. 2 Choisissez le séparateur — un point-virgule si le fichier va dans Excel.
3. 3 Cliquez sur Convertir, puis copiez le résultat ou téléchargez le .csv.

Un arbre ne rentre pas dans une grille, alors on l’aplatit

Un objet imbriqué devient une colonne pointée : {"city":{"name":"London"}} donne la colonne city.name. Sans cela, un convertisseur écrit « [object Object] » dans la case — le fichier s’ouvre, semble valide, et la moitié de vos données a disparu. Les listes de valeurs simples sont réunies dans une case ; les listes d’objets reçoivent des colonnes numérotées.

[
  {
    "name": "Ada",
    "city": { "name": "London" },
    "note": "Loves \"tea\""
  },
  {
    "name": "Grace",
    "city": { "name": "New York, NY" },
    "tags": ["math", "navy"]
  }
]

name,city.name,note,tags
Ada,London,"Loves ""tea""",
Grace,"New York, NY",,math; navy

Les colonnes viennent de toutes les lignes, pas de la première

Dans de vraies données, les enregistrements ont rarement les mêmes champs : un champ facultatif apparaît au quarantième et jamais avant. Un convertisseur qui ne lit que le premier enregistrement supprime cette colonne en silence, et rien dans la sortie ne le signale. Ici l’en-tête est l’union de toutes les clés rencontrées, dans leur ordre d’apparition, et les champs absents donnent une case vide.

Une seule virgule égarée décale toutes les colonnes

Toute valeur contenant le séparateur, un guillemet ou un saut de ligne doit être entourée de guillemets, ceux qui sont à l’intérieur étant doublés. C’est ce qu’exige le standard CSV, et c’est là que les convertisseurs se trompent le plus souvent. Une adresse avec une virgule, un commentaire avec un retour à la ligne, un nom avec une apostrophe — chacun casse en silence un fichier qui saute cette étape.

Excel casse les fichiers CSV de deux façons différentes

D’abord, sans marque d’ordre des octets, il lit l’UTF-8 comme la page de codes locale : les accents et les caractères non latins deviennent de la bouillie. Ensuite, dans de nombreuses locales, il attend un point-virgule et non une virgule, et tasse chaque ligne dans une seule colonne. Les deux sont des options ici, désactivées par défaut — la norme dit virgule et pas de marque, et le fichier part le plus souvent vers un script, pas vers un tableur.