JSON : définition simple
Le JSON (JavaScript Object Notation) est un format de texte qui sert à échanger des données entre deux logiciels, sous forme de paires « nom : valeur ». Il se lit aussi bien par une personne que par une machine, ce qui en fait le format le plus courant des échanges entre sites, applications et services en ligne.

À retenir
- Un JSON est un simple fichier texte : vous pouvez l’ouvrir dans le bloc-notes et comprendre ce qu’il contient.
- La plupart des échanges entre un site, une application mobile et un service en ligne (paiement, agenda, livraison) passent par du JSON.
- Il ne protège rien par lui-même : la sécurité vient de la connexion (HTTPS) et des droits d’accès, pas du format.
Un JSON lu pas à pas
Le plus simple est de lire un JSON comme une fiche cartonnée.
Chaque ligne porte une étiquette et une valeur, et la fiche entière est entourée d’accolades. Prenons la fiche d’un produit de la boutique d’un caviste, telle que le site la transmet à l’application mobile.
Une fiche produit, de la boutique à l’application
- Les accolades. Tout commence par une accolade ouvrante et finit par une accolade fermante. Elles délimitent un objet, c’est-à-dire une fiche complète, ici un seul vin.
- Une paire d’accolades = une fiche
- Les fiches peuvent s’emboîter
- Une accolade oubliée = fichier invalide
- Les paires nom et valeur. À l’intérieur, chaque information est écrite « nom » : valeur, séparée de la suivante par une virgule. Par exemple
"nom": "Côtes du Rhône 2022", puis"prix": 12.5et"en_stock": true.- Le nom est toujours entre guillemets doubles
- Le prix s’écrit avec un point, pas une virgule
- Vrai ou faux s’écrit true ou false
- Les listes. Quand une information compte plusieurs éléments, ils sont placés entre crochets, par exemple les photos du produit ou les tailles de bouteille. L’application les affiche l’une après l’autre.
- Crochets = liste d’éléments
- Une liste peut contenir des fiches
- L’ordre des éléments est conservé
Du JSON au quotidien
Vous n’ouvrez presque jamais un JSON, mais vous en utilisez tous les jours.
Voici six situations d’entreprise où il circule en coulisses.
| Situation | Ce que transporte le JSON | Ce que vous y gagnez |
|---|---|---|
| Une commande en ligne | Le site envoie à votre logiciel de livraison le nom, l’adresse et la liste des articles de la commande. | Plus aucune commande à recopier à la main. |
| Une prise de rendez-vous | Le formulaire lit les créneaux libres de votre agenda et y inscrit la réservation du client. | Un agenda toujours à jour, sans double réservation. |
| Une application mobile d’artisan | L’appli récupère la liste des chantiers du jour et renvoie les photos et les heures saisies sur place. | Le bureau voit l’avancement en temps réel. |
| Les horaires sur votre site | Le site lit les horaires saisis une fois dans un outil central et les affiche partout. | Des horaires modifiés à un seul endroit. |
| Les réglages d’un site | Un fichier de configuration, comme package.json, liste les composants utilisés par le site et leurs versions. | Un site reconstruit à l’identique sur un autre serveur. |
| Un export de vos données | Votre outil de gestion produit un fichier JSON avec vos clients, vos produits ou vos factures. | Vos données restent récupérables si vous changez d’outil. |
Les éléments d’un JSON
Un JSON n’est composé que de six sortes de valeurs.
Les connaître suffit à lire un fichier ou à comprendre ce que vous décrit un développeur. Elles sont la base des échanges d’une API ou d’une API REST.
Le texte
Toujours entre guillemets doubles : un nom, une adresse, une description. Les accents sont admis.
- "ville": "Avignon"
- Guillemets droits uniquement
- Un texte peut être vide
Le nombre
Écrit sans guillemets, avec un point pour les décimales. Il sert aux prix, aux quantités, aux dates converties en chiffres.
- 12.5 et non 12,5
- Pas d’espace entre les milliers
- Pas de symbole € dedans
Vrai ou faux
Deux valeurs seulement, true et false, sans guillemets. Elles répondent à une question par oui ou non.
- "en_stock": true
- Toujours en minuscules
- Pratique pour les cases à cocher
L’objet
Une fiche entre accolades, qui regroupe plusieurs paires nom et valeur. Un client, un produit, une commande sont chacun un objet.
- Peut contenir d’autres objets
- Chaque nom est unique dans la fiche
- Base de tout échange
La liste
Une suite d’éléments entre crochets, séparés par des virgules. Les lignes d’une commande ou les photos d’un produit en sont des exemples.
- Peut mélanger plusieurs types
- Peut être vide
- Ordre conservé
La valeur vide
Le mot null indique qu’une information existe mais n’a pas de valeur, par exemple un numéro de téléphone non renseigné.
- Différent de zéro
- Différent d’un texte vide
- Évite les cases oubliées
Questions fréquentes
Que veut dire JSON ?
JSON signifie JavaScript Object Notation, en français « notation d’objet JavaScript ». Le nom vient du langage JavaScript qui l’a inspiré, mais le format est indépendant de tout langage : PHP, Python, Java ou une application mobile le lisent et l’écrivent sans difficulté.
Un JSON, est-ce la même chose qu’une API ?
Non. Une API est le canal par lequel deux logiciels se parlent ; le JSON est la façon dont ils écrivent ce qu’ils se disent. Une API répond le plus souvent en JSON, comme un serveur répond en français ou en anglais, mais elle peut aussi utiliser d’autres formats.
Quelle différence entre JSON, XML et CSV ?
Le CSV est un tableau à plat, pratique pour Excel mais pauvre dès que les données s’emboîtent (une commande et ses lignes). Le XML sait emboîter les informations, mais il est plus verbeux et plus lourd à lire. Le JSON garde l’emboîtement avec peu de signes, d’où son succès dans les échanges entre sites et applications.
Un fichier JSON est-il sécurisé ?
Le format n’apporte aucune protection : un JSON est du texte lisible par quiconque l’ouvre. Pour protéger les données, il faut chiffrer la connexion (HTTPS), exiger une authentification et limiter ce que chaque accès peut lire. Ne placez jamais de mot de passe ou de clé secrète en clair dans un JSON publié ou partagé.
Pourquoi mon fichier JSON est-il refusé ?
Dans la grande majorité des cas, c’est une erreur de ponctuation : une virgule en trop après le dernier élément, un guillemet simple à la place d’un guillemet double, une accolade non fermée ou un commentaire (le JSON n’en admet pas). Un validateur en ligne ou l’éditeur de code souligne la ligne fautive.
Faut-il connaître le JSON pour faire développer un logiciel ?
Non. C’est l’affaire de l’équipe technique. Vous avez en revanche intérêt à demander que les échanges soient documentés : quelles données circulent, dans quel sens et avec quels droits. Cette documentation fait partie des livrables à réclamer à votre prestataire.
À lire aussi
Besoin d’échanger des données ?
Le cadrage dresse la liste de vos outils et des données qui doivent circuler entre eux. Voici les prestations où le JSON est au cœur du travail.

Logiciel sur mesure
Un logiciel métier qui échange ses données avec votre comptabilité, votre site ou vos partenaires.
- Cadrage de vos outils existants
- Échanges structurés et documentés
- Code source livré

Application mobile
Une application qui lit et envoie ses données à votre site ou à votre logiciel.
- Données partagées avec votre site
- Maquettes validées avant le code
- Publication sur les deux stores

Site e-commerce
Une boutique reliée au paiement, à la livraison et à votre stock.
- Commandes transmises automatiquement
- Stock et livraison reliés
- Boutique gérée par vous

Logiciel SaaS
Un service en ligne qui expose ses données à d’autres outils de vos clients.
- Comptes multi-entreprises
- API pour vos clients
- Code source livré




Skyward Resto



