Version pour Français. Erreurs fréquentes des données françaises (virgule décimale, codes postaux et codes INSEE pris pour des nombres) et requêtes JSONPath sur une vraie réponse de geo.api.gouv.fr. Version US

Formateur et validateur JSON

Formatez, minifiez et validez du JSON en ligne, puis interrogez-le avec JSONPath. Exemples avec l’API geo.api.gouv.fr, les codes INSEE et la virgule décimale.

L’outil interactif se charge ici quand JavaScript s’exécute.

À propos de cet outil

Formateur et validateur JSON : de quoi s’agit-il ?

Collez du JSON : le formateur le vérifie avec le même JSON.parse que les navigateurs et Node.js, puis le rend indenté sur deux espaces ou minifié sur une ligne. Le champ « Requête JSONPath » extrait une valeur d’une longue réponse sans la parcourir à la main.

Avec des données françaises, deux erreurs reviennent souvent. La virgule décimale d’abord : {"prix": 1250,50} n’est pas du JSON valide, il faut écrire 1250.50. Les codes ensuite : un code postal ou un code INSEE comme 01350 ne peut pas être un nombre JSON, car un nombre ne commence pas par un zéro. L’API officielle geo.api.gouv.fr renvoie d’ailleurs ces codes sous forme de chaînes, "01350" ou "2A004" pour Ajaccio.

Les accents et la cédille passent sans problème si le fichier est enregistré en UTF-8, comme le demande la RFC 8259 pour les échanges entre systèmes. Le validateur ne contrôle que la syntaxe : il ne vérifie pas un schéma JSON et n’indique ni ligne ni colonne d’erreur.

  • Validation par JSON.parse à chaque saisie
  • Indentation sur deux espaces ou minification
  • Requêtes JSONPath avec la bibliothèque jsonpath-plus
  • Copie et téléchargement en fichier .json
  • Traitement dans le navigateur, sans envoi des données
Lire le guide : JSON Formatting, Validation and JSONPath: A Practical Guide

Mis à jour le

Mode d’emploi : Formateur et validateur JSON

  1. Collez votre JSON dans « JSON d’entrée » : l’indicateur passe aussitôt à « Valide » ou « Non valide ».
  2. Cliquez sur « Embellir » pour l’indenter sur deux espaces, ou sur « Minifier » pour le mettre sur une ligne.
  3. Copiez le résultat de « Sortie » avec l’icône de copie, ou téléchargez-le avec l’icône de téléchargement sous le nom formatted.json.
  4. Saisissez une expression dans « Requête JSONPath », par exemple $[0].nom, puis cliquez sur « Exécuter la requête ».
  5. Pour un long document, passez en « Plein écran ».

Exemples de calcul

Code postal pris pour un nombre

Entrée

{"code": 01350}

Sortie

Non valide

Un nombre JSON ne peut pas commencer par 0. Écrivez {"code": "01350"} : les codes postaux et les codes INSEE sont des identifiants, pas des quantités.

Requête sur l’API Découpage administratif

Entrée

Réponse de geo.api.gouv.fr/communes?codePostal=69001 avec les champs nom, code, codesPostaux et population ; requêtes $[0].codesPostaux[0] puis $[0].codesPostaux.length

Sortie

["69001"] puis [9]

La commune renvoyée est Lyon, code INSEE "69123", avec neuf codes postaux, du 69001 au 69009. Le résultat d’une requête JSONPath est toujours un tableau, même pour une seule valeur.

Filtrer des communes

Entrée

Réponse de geo.api.gouv.fr pour nom=Saint-Étienne (3 communes) avec $[?(@.population>2000)].nom

Sortie

["Saint-Étienne", "Saint-Étienne-du-Bois"]

Le filtre garde les communes de plus de 2 000 habitants. La requête $[*].code renvoie ["42218", "27538", "01350"] : le zéro initial est conservé parce que les codes sont des chaînes.

Accents et cédille

Entrée

{"ville":"Besançon","rue":"Rue de l’Église"}

Sortie

Formaté sur quatre lignes, indentation de deux espaces, accents et apostrophe typographique inchangés

JSON.stringify écrit les caractères non ASCII tels quels, sans séquences \u. Enregistrez la sortie en UTF-8 pour qu’elle s’affiche correctement ailleurs.

Cas d’usage courants

  • Lire une réponse d’API

    Rendre lisible la réponse d’une API publique comme geo.api.gouv.fr et en extraire un champ.

  • Vérifier un fichier de configuration

    Trouver la virgule en trop ou le guillemet manquant dans un package.json.

  • Contrôler un export de tableur

    Repérer les nombres à virgule décimale et les codes sans zéro initial.

  • Préparer une requête de test

    Minifier un JSON pour une variable d’environnement ou une commande curl.

Conseils et limites

  • Gardez les identifiants (SIRET, numéros de compte, codes) en chaînes : au-delà de 2⁵³, un entier perd sa précision en JavaScript.
  • Les montants circulent souvent en chaînes comme "1250.50" pour éviter les erreurs d’arrondi ; convertissez-les avant de les comparer.
  • Le formateur fonctionne dans le navigateur : les données collées ne sont pas envoyées à un serveur.

Sources et lectures complémentaires

  1. API Découpage administratif (geo.api.gouv.fr), point d’accès /communes, État français, geo.api.gouv.fr. Réponse JSON consultée en novembre 2026 : codes INSEE et codes postaux sous forme de chaînes, par exemple "01350" ou "2A004".
  2. RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format, IETF. Nombres avec un point décimal et sans zéro initial, échange en UTF-8.

Questions fréquentes

Pourquoi mon JSON est-il non valide ?

Le plus souvent : une virgule après le dernier élément, des apostrophes au lieu de guillemets doubles, un commentaire, une virgule décimale ou un nombre qui commence par 0. JSON n’accepte rien de tout cela. Avec un export de tableur français, vérifiez d’abord les nombres et les codes postaux.

Le JSON accepte-t-il les accents ?

Oui. Une chaîne peut contenir n’importe quel caractère Unicode. Pour les échanges entre systèmes, la RFC 8259 impose UTF-8 : un fichier enregistré en Windows-1252 peut arriver avec des caractères illisibles.

Comment écrire un nombre décimal en JSON ?

Avec un point : 1250.50. La virgule sépare les éléments en JSON, si bien que 1250,50 est lu comme deux valeurs et rend le document non valide.

Comment interroger un JSON avec JSONPath ?

L’expression commence par $ pour le document entier. $[0] désigne le premier élément d’un tableau, * tous les éléments, [?(@.population>2000)] filtre selon une condition. Le résultat est toujours un tableau.

Le validateur vérifie-t-il un schéma JSON ?

Non. Il vérifie seulement que le texte est du JSON valide. Pour contrôler les champs obligatoires et les types, il faut une validation par schéma.

Mes données sont-elles envoyées quelque part ?

Non. Mise en forme, minification, validation et requêtes se font dans le navigateur. Les données collées restent sur votre appareil.

Existe-t-il un guide complet sur Formateur et validateur JSON ?

Oui. « JSON Formatting, Validation and JSONPath: A Practical Guide » présente le contexte, le fonctionnement, les pièges courants et des exemples de calcul. Lire le guide complet.