Du CSV au JSON : Travailler avec des données tabulaires dans les APIs

CSV est le format que le monde des affaires utilise encore pour échanger des données : exports de CRM, relevés bancaires, rapports d'inventaire. JSON est ce qu'attendent la plupart des APIs REST et serverless. Passer de l'un à l'autre proprement économise des heures de scripts ponctuels.

La forme habituelle : tableau d'objets

Pour les APIs, la forme JSON la plus pratique est un tableau d'objets, un objet par ligne, avec les clés issues de la ligne d'en-tête :

[
  { "sku": "A-100", "qty": "12", "warehouse": "East" },
  { "sku": "B-220", "qty": "3", "warehouse": "West" }
]

Notez que le CSV transporte des chaînes de caractères, sauf si vous ajoutez une étape de typage séparée. Votre API doit convertir qty en nombre si nécessaire.

En-têtes et cohérence

• La première ligne doit contenir les noms de colonnes ; renommez les doublons avant la conversion.
• Attention aux caractères BOM en début de fichiers UTF-8 exportés depuis Excel — ils peuvent perturber un parseur naïf et transformer votre premier en-tête en \uFEFFsku.
• Les champs entre guillemets peuvent contenir des virgules et des sauts de ligne ; les bons parseurs les gèrent ; un simple découpage par virgule avec une regex, non.

Quand JSON → CSV

Les outils de reporting et les pièces jointes par e-mail veulent souvent du CSV. Exportez une ligne par objet ; utilisez l'union de toutes les clés comme colonnes si les objets diffèrent (les lignes incomplètes obtiennent des cellules vides).

Valider avant la mise en production

Après la conversion, faites passer votre JSON dans un JSON Formatter pour détecter les virgules en fin de ligne, les guillemets simples ou les valeurs NaN accidentelles provenant de formules de tableur.

Si votre pipeline accepte également du YAML depuis des dépôts de configuration, YAML to JSON peut aider à tout aligner sur les mêmes tests de schéma JSON.

Tester en local

Notre convertisseur CSV ↔ JSON fonctionne dans le navigateur : collez un exemple d'export, obtenez du JSON formaté, ou faites l'inverse pour un rapport rapide. Aucun fichier ne quitte votre appareil.

Traitez le CSV comme une entrée non fiable si des utilisateurs le téléversent — limitez la taille, recherchez les injections de formules Excel (=cmd|), et n'exécutez jamais des cellules comme du code.

Résumé

• Privilégiez le format en-têtes + lignes → tableau d'objets pour les APIs.
• Respectez les règles de mise entre guillemets ; évitez les parseurs CSV faits maison en production.
• Validez toujours le JSON et le schéma avant d'envoyer vers des services en aval.