Formateur et validateur JSON

Comment utiliser le formateur JSON

Ce formateur JSON rend le JSON lisible ou compact et indique précisément où se trouve une éventuelle erreur de syntaxe. Collez votre JSON dans le volet de gauche et choisissez Formater. L’outil vérifie d’abord que le texte est un JSON valide, puis le met en forme proprement, indenté de deux ou quatre espaces ou d’une tabulation. Minifier fait l’inverse : il supprime tous les espaces et sauts de ligne superflus, pour obtenir une version compacte destinée à un fichier de configuration, une requête de test ou une variable d’environnement.

Activez Trier les clés par ordre alphabétique si vous voulez comparer deux réponses d’API. Les objets sont alors triés par nom de clé à tous les niveaux, tandis que l’ordre au sein des tableaux reste inchangé, car en JSON cet ordre a bien un sens. Sous le résultat, vous voyez la taille du JSON, le nombre de clés qu’il contient et la profondeur d’imbrication de la structure. Pratique pour vérifier rapidement si une réponse est complète ou anormalement volumineuse.

Copier place le résultat dans votre presse-papiers et Télécharger vous fournit un fichier .json. Tout se passe dans votre navigateur. L’outil convient donc aux données que vous souhaitez manipuler avec précaution, comme une réponse d’API contenant des données clients ou une configuration comportant des adresses internes.

Valider du JSON : localiser les erreurs par ligne et colonne

Un validateur JSON ne doit pas seulement vous dire que quelque chose ne va pas, mais aussi où. Lorsqu’une API ou un import rejette un fichier, vous n’obtenez souvent qu’un message vague comme « Unexpected token ». Cet outil localise lui-même l’erreur et affiche le numéro de ligne, la colonne et le texte environnant, avec la ligne surlignée dans le volet de saisie. Aller à l’erreur place directement votre curseur au bon endroit.

La plupart des erreurs viennent de ce que JSON ressemble à JavaScript tout en étant plus strict. Les clés doivent toujours être entre guillemets doubles, les guillemets simples sont interdits et aucune virgule ne doit suivre le dernier élément d’un objet ou d’un tableau. Les commentaires avec // ou /* */ n’existent pas non plus en JSON, pas plus que undefined, NaN ou les écritures Python True et None. Lorsque l’outil reconnaît un tel motif, il ajoute un conseil concret.

Une erreur ne se trouve pas toujours exactement là où elle est signalée. S’il manque une virgule ou un crochet fermant, l’analyseur ne s’en aperçoit qu’au caractère suivant. Regardez donc aussi la ligne précédente. C’est pourquoi l’extrait du message d’erreur affiche les deux lignes qui précèdent l’erreur.

Qu’est-ce que JSON et pourquoi la mise en forme compte-t-elle ?

JSON (JavaScript Object Notation) est le format standard que les systèmes utilisent pour échanger des données. Presque toutes les API modernes, de votre boutique en ligne et de votre logiciel comptable à un CRM ou un prestataire de paiement, envoient et reçoivent du JSON. Le format ne compte que quelques éléments de base : des objets avec des clés et des valeurs, des tableaux, des chaînes, des nombres, true, false et null. C’est justement parce qu’il est si simple que tous les langages de programmation savent l’utiliser.

Pour un ordinateur, la mise en forme ne change rien : un JSON minifié et un JSON joliment indenté signifient exactement la même chose. Pour un humain, la différence est énorme. Une réponse d’API sur une seule longue ligne est illisible, alors qu’une version formatée montre la structure d’un coup d’œil : quels champs existent, ce que contient une liste et où une valeur manque. La minification sert quand la taille du fichier compte, par exemple avec de gros volumes de trafic ou un stockage limité.

Attention aux très grands nombres. JSON lui-même n’impose aucune limite, mais les navigateurs et JavaScript ne calculent avec précision que jusqu’à environ 16 chiffres. Un identifiant ou un numéro de compte plus long peut donc ressortir légèrement différent après la mise en forme. C’est pourquoi les systèmes qui échangent de telles valeurs les envoient généralement sous forme de chaînes.

Du JSON épars à une intégration fiable

Un formateur est idéal pour inspecter une réponse d’API ou vérifier une configuration. Si vous copiez régulièrement du JSON d’un système, le modifiez et le collez dans un autre, c’est le signe qu’une véritable intégration vous ferait gagner du temps et éviterait des erreurs. Une bonne intégration valide automatiquement les données selon un schéma, intercepte les erreurs avant qu’elles n’atteignent vos données et consigne ce qui a échoué.

Pour concevoir une telle intégration, on regarde au-delà du seul format : quels champs sont obligatoires, comment traiter les valeurs manquantes, que se passe-t-il quand un système est momentanément indisponible et comment éviter qu’une commande soit traitée deux fois. Ce sont précisément les points où le copier-coller manuel finit tôt ou tard par déraper.