Validateur de schéma JSON
Validez un document JSON par rapport à un schéma JSON et voyez précisément où il échoue.
Exemples d'utilisation
Vérifier la forme d'une réponse d'API
Collez le schéma promis par votre API et un exemple de réponse pour confirmer que les champs, types et propriétés obligatoires correspondent vraiment avant la mise en production.
Déboguer un fichier de configuration en échec
Quand un outil rejette votre configuration avec une erreur vague, validez-la ici par rapport au schéma documenté pour voir précisément quel champ pose problème et pourquoi.
Relire le contrat de données d'une pull request
Avant d'approuver une modification d'une structure JSON partagée, collez le schéma mis à jour et quelques exemples de données pour vérifier que rien ne casse silencieusement.
Valider un fichier de configuration par rapport à un schéma documenté
De nombreux outils en ligne de commande publient un JSON Schema pour leur fichier de configuration — collez le vôtre à côté du schéma publié pour repérer les fautes de frappe et les erreurs de type avant d'exécuter l'outil.
Tester les cas limites d'un schéma que vous êtes en train d'écrire
En rédigeant un nouveau schéma, collez quelques documents volontairement invalides (champ obligatoire manquant, mauvais type) pour confirmer que votre schéma les rejette bien comme prévu.
Questions fréquentes
Quelle version (draft) de JSON Schema est prise en charge ?
Cet outil valide par rapport à JSON Schema Draft-07, le draft le plus compatible et le plus largement pris en charge. Les mots-clés introduits uniquement dans des drafts plus récents, comme 2019-09 ou 2020-12 (par exemple '$recursiveRef' ou la nouvelle forme de tableau 'prefixItems'), ne sont pas reconnus et peuvent être ignorés silencieusement.
Mon schéma ou mes données sont-ils envoyés à un serveur ?
Non. Le schéma et le document sont tous deux validés entièrement dans votre navigateur grâce à la bibliothèque ajv. Rien n'est envoyé où que ce soit.
Quelle est la différence entre 'Schéma invalide' et un échec de validation ?
'Schéma invalide' signifie que le JSON Schema lui-même est mal formé ou contradictoire et n'a pas pu être compilé, donc la validation n'a même pas pu s'exécuter. Un échec de validation signifie que le schéma a été compilé correctement, mais que votre document ne respecte pas ses règles — chaque règle enfreinte est listée avec le chemin exact dans vos données.
Comment lire une erreur comme 'à `/user/age`: must be >= 0' ?
Le chemin indique où se situe le problème dans votre document JSON, en utilisant '/' pour séparer les clés imbriquées et les index de tableau. Le message après les deux-points explique quelle règle du schéma a été enfreinte.
Un schéma peut-il en référencer un autre avec $ref ?
Uniquement au sein du même document collé, à l'aide de pointeurs JSON locaux au même document (comme '#/definitions/address'). Les références à un fichier externe ou à une URL ne sont pas résolues, puisque rien n'est récupéré sur le réseau.
Que fait réellement respecter 'additionalProperties: false' ?
Il fait rejeter par le schéma tout objet comportant des propriétés non explicitement listées, ce qui est un moyen courant de détecter des fautes de frappe dans les noms de champs (comme 'eamil' au lieu de 'email') qui passeraient sinon inaperçues.
Un schéma vide ({}) est-il valide ?
Oui — un schéma vide n'impose aucune contrainte : tout document JSON est donc validé avec succès par rapport à lui.