GuideNiveau · Débutant~5 min de lecture

JSON

Comprendre les données structurées.

Un tableau suffit pour une liste simple. Mais comment représenter une personne qui possède plusieurs adresses, des compétences et des préférences ? JSON permet de regrouper ces informations dans une structure lisible et réutilisable.

À la fin de ce guide, tu sauras :

  • Repérer les clés et les valeurs dans un document JSON
  • Distinguer un objet d’une liste
  • Lire une fiche contenant des informations imbriquées
  • Vérifier la structure d’un petit fichier JSON
Tags
  • JSON
  • API
  • Automatisation
Publié
JSON expliqué simplement : clés, valeurs, API et automatisation (#064)Voir sur YouTube (nouvel onglet)

1. Du CSV au JSON

Un fichier CSV représente bien un tableau : une ligne par personne, une colonne par information. Il devient moins pratique quand une personne a plusieurs adresses ou une liste de compétences.

JSON (JavaScript Object Notation) est un format texte pour organiser et transmettre des données structurées. Il ressemble à une fiche qui peut contenir des sous-sections et des listes. Il n’est pas nécessaire de connaître JavaScript pour le lire.

L’idée centrale

Une clé nomme une information. Une valeur contient cette information. Par exemple, la clé "nom" peut avoir pour valeur "Alice".

2. Clés, valeurs et signes

Voici une première fiche JSON. Les guillemets entourent les clés et les valeurs textuelles.

{
  "nom": "Alice",
  "email": "alice@exemple.com",
  "ville": "Montréal"
}
  • Repérer les accolades {} qui délimitent l’objet
  • Lire les deux-points : entre chaque clé et sa valeur
  • Repérer les virgules qui séparent les entrées

Une valeur peut être du texte, un nombre, true, false, null, une liste ou un autre objet. Un nombre et un booléen ne prennent pas de guillemets.

3. Objets et listes

Une valeur peut contenir une autre structure. Ici, adresse contient un objet et competences contient une liste.

{
  "nom": "Alice",
  "adresse": {
    "ville": "Montréal",
    "pays": "Canada"
  },
  "competences": ["HTML", "CSS", "JavaScript"],
  "actif": true
}

Les accolades regroupent les clés et les valeurs d’un objet. Les crochets regroupent les éléments d’une liste. On peut ainsi représenter plusieurs adresses ou commandes sans écraser toutes les informations sur une seule ligne.

Attention : JSON est strict. Une clé sans guillemets, une virgule après le dernier élément ou une accolade manquante rendent le document invalide. Les commentaires ne font pas partie du format JSON standard.

4. Où utilise-t-on JSON ?

Les API échangent souvent des données JSON entre applications. Un outil d’automatisation comme n8n peut recevoir une fiche, lire une valeur, puis transmettre le résultat à l’étape suivante. Une réponse d’IA peut aussi être demandée sous forme de champs précis, comme un titre, un résumé et une liste de points clés.

Une structure rend ces données plus faciles à exploiter automatiquement. Elle ne garantit toutefois ni leur exactitude ni la confidentialité des informations : il faut vérifier les réponses et éviter d’envoyer des données sensibles sans précaution.

Tu peux également rencontrer XML, un autre format d’échange qui utilise des balises. JSON utilise plutôt des clés, des objets et des listes.

5. Mini-exercice : lire une fiche JSON

Objectif : identifier les structures et vérifier qu’une fiche est valide.

  1. Copier le second exemple dans un fichier utilisateur.json
  2. Repérer la valeur de nom et la liste competences
  3. Ajouter "codePostal": "H2X 1Y4" dans l’objet adresse, après pays
  4. Vérifier les virgules et les accolades dans un validateur JSON ou un éditeur de code

Question pour vérifier ta compréhension :

Pourquoi faut-il ajouter une virgule après "pays": "Canada", mais pas après le nouveau "codePostal" ?

Afficher la réponse

La virgule sépare deux entrées. pays est maintenant suivi d’une autre clé, tandis que codePostal est la dernière entrée de l’objet adresse.

6. À retenir

JSON est un format texte pour des données structurées. Les clés nomment les informations, les valeurs les contiennent. Une valeur peut aussi être un objet ou une liste. Savoir lire cette structure aide à comprendre ce que les API, les automatisations et les outils d’IA échangent.