Validateur JSON Schema

Collez un JSON Schema d’un côté et un document JSON de l’autre pour vérifier les données par rapport au schéma. Chaque échec indique le chemin exact dans le document et la règle enfreinte, qu’il s’agisse d’un champ obligatoire manquant, d’un type incorrect ou d’un format invalide comme une adresse e-mail.

Que vérifie l’outil, et comment les erreurs sont-elles présentées ?

L’outil valide votre document par rapport à toutes les règles du schéma en une seule passe, plutôt que de s’arrêter à la première erreur : vous obtenez donc la liste complète des problèmes d’un coup. Chaque entrée indique le chemin dans le document sous forme de JSON Pointer, par exemple /users/0/email, le mot-clé fautif (required, type, format, etc.), et le message d’Ajv qui décrit précisément le problème. Quand c’est possible, l’outil pointe aussi vers le numéro de ligne dans votre JSON collé, pour aller droit à la valeur incriminée sans compter les accolades. Les vérifications de format, comme s’assurer qu’une chaîne est une adresse e-mail, une date ou une URL valides, s’appuient sur le paquet ajv-formats.

Avant la validation, le schéma et le document sont tous deux analysés en tant que JSON, et toute erreur de syntaxe est signalée avec son propre numéro de ligne plutôt que par un échec générique. Si le schéma lui-même est malformé au point qu’Ajv ne parvient pas à le compiler, par exemple en référençant un mot-clé non supporté, cela apparaît comme une erreur de compilation distincte.

Quelle version de JSON Schema l’outil prend-il en charge ?

L’outil lit le champ $schema de votre schéma et adapte son validateur en conséquence : un schéma qui déclare la Draft 2020-12 est compilé avec la version 2020 d’Ajv, et tout le reste, y compris l’ancien style Draft-07, retombe sur Ajv standard. Vous pouvez donc coller l’un ou l’autre style sans choisir de mode à la main. Voir json-schema.org pour la spécification complète et les différences entre les drafts.

Mon schéma ou mes données sont-ils envoyés quelque part ?

Non. La validation se fait entièrement dans votre navigateur avec Ajv, un validateur JSON Schema très utilisé, et ni le schéma ni le document que vous collez ne sont transmis où que ce soit. Cela compte quand vous vérifiez des fichiers de configuration, des payloads d’API ou des jeux de test contenant de vraies données utilisateur, des identifiants ou d’autres champs que vous préférez ne pas envoyer à un serveur.

Utile pour écrire un schéma qui définit un contrat d’API, comprendre pourquoi un payload échoue à la validation en CI, ou revérifier un fichier de configuration avant de le déployer.