Aller au contenu
Module
Tech

JSON : définition et usage dans un produit

JSON (JavaScript Object Notation) est un format texte qui représente des données structurées avec des paires clé-valeur et des listes. Il connaît quelques types simples : chaînes de caractères, nombres, booléens, la valeur null, des objets entre accolades et des tableaux entre crochets. Lisible par un humain et facile à traiter par une machine, il est devenu le format d'échange par défaut des API web.

Définition rédigée par Alex Dionisio, Senior Product Manager. Mis à jour le 13 novembre 2026.

Pourquoi c’est important pour un PM

Réponses d'API, charges utiles de webhooks, fichiers de configuration, événements analytics et sorties structurées d'un LLM s'écrivent le plus souvent en JSON. Un PM qui sait le lire peut vérifier lui-même ce qu'une API renvoie, repérer un champ manquant ou mal typé et rédiger des exemples précis dans une spec. Il gagne du temps sur les allers-retours avec l'équipe technique.

Exemple

En testant une API de livraison, un PM remarque dans la réponse JSON que le champ « date_livraison » vaut null pour les colis en point relais. La spec prévoyait d'afficher cette date partout : il ajoute un cas pour ce statut, avec un texte de remplacement, avant que le développement ne commence.

Points clés

  • Un objet regroupe des paires clé-valeur ; un tableau contient une liste ordonnée de valeurs.
  • JSON ne gère pas de type date : les dates circulent comme chaînes, souvent au format ISO 8601.
  • Un JSON Schema décrit la forme attendue des données et permet de les valider automatiquement.
  • Une virgule en trop ou un guillemet manquant suffit à rendre un document illisible pour la machine.

Erreurs fréquentes

  • Supposer qu'un champ sera toujours présent alors que l'API peut l'omettre ou renvoyer null.
  • Confondre le nombre 10 et la chaîne « 10 », ce qui casse tris et calculs.
  • Écrire des exemples de spec à la main sans vérifier qu'ils sont du JSON valide.

Pour aller plus loin dans Module

Les formations et les leçons qui traitent cette notion :

Guides sur ce thème