Validateur de schéma JSON
Validez des données JSON par rapport à un schéma JSON et affichez chaque erreur avec le chemin de la valeur non conforme et la règle enfreinte, y compris pour des formats comme e-mail et date-heure. L’outil s’exécute dans votre navigateur.
Entrée
Sortie
Documentation
Qu’est-ce qu’un schéma JSON ?
Un schéma JSON décrit à quoi doit ressembler un document JSON : les propriétés d’un objet, celles qui sont obligatoires, le type de chaque valeur, les plages et longueurs autorisées, ainsi que les motifs et formats tels que les adresses e-mail ou les dates. Les API, les fichiers de configuration et les générateurs de formulaires utilisent des schémas pour vérifier les données avant de leur faire confiance, et OpenAPI les utilise pour décrire les corps des requêtes et des réponses.
Comment utiliser le validateur
- Collez ou saisissez le schéma JSON dans le premier champ.
- Collez ou saisissez les données JSON à vérifier dans le deuxième champ.
- Le résultat s’affiche au fur et à mesure de la saisie : soit le JSON est valide, soit toutes les erreurs sont répertoriées avec le chemin de la valeur en échec, le mot-clé du schéma enfreint et une brève explication.
- Chaque valeur en échec est marquée dans les données. Cliquez sur une erreur pour faire défiler les données jusqu’à celle-ci, ou cliquez sur un marqueur pour retrouver l’erreur correspondante dans la liste.
Le champ Version du schéma indique la version de JSON Schema utilisée pour vérifier les données.
Versions prises en charge
Le mot-clé $schema du schéma détermine la version :
- Version 2020-12 :
https://json-schema.org/draft/2020-12/schema - Version 2019-09 :
https://json-schema.org/draft/2019-09/schema - Version 7 :
http://json-schema.org/draft-07/schema# - Version 6 :
http://json-schema.org/draft-06/schema#
Un schéma sans $schema est vérifié selon la version 7. La version 4 et les versions antérieures ne sont pas prises en charge. Le schéma lui-même est d’abord vérifié selon le métaschéma de sa version. Ainsi, une faute de frappe telle que "type": "strin" est signalée comme un schéma invalide plutôt que d’être ignorée. Les annotations comme title, description et examples sont acceptées, tout comme les mots-clés inconnus de la version, tels que vos propres annotations x- : ils sont ignorés.
Comprendre les erreurs
- Les chemins sont écrits au format JSONPath, à partir de
$, qui représente le document entier :$.ingredients[1].unitdésigne la propriétéunitdu deuxième ingrédient. - Une propriété obligatoire manquante est signalée sur l’objet qui devrait la contenir, et le nom de la propriété apparaît dans le message.
- Une propriété supplémentaire non autorisée par le schéma est signalée à l’emplacement du nom de cette propriété.
- Pour
enumetconst, le message répertorie les valeurs autorisées. - Avec
anyOfetoneOf, chaque branche qui échoue ajoute ses propres erreurs, suivies d’une erreur pour le mot-clé lui-même. Une seule valeur incorrecte peut donc produire plusieurs erreurs.
Les messages d’erreur proviennent de la bibliothèque Ajv et sont en anglais.
Formats
Les valeurs associées à un format sont également vérifiées : email, uri, uri-reference, date, time, date-time, duration, uuid, ipv4, ipv6, hostname, regex, json-pointer, et bien d’autres. Un format inconnu du validateur est ignoré, conformément à la spécification JSON Schema.
Références
$ref fonctionne pour les définitions présentes dans le même schéma, telles que #/$defs/address ou #/definitions/address. Les références à d’autres fichiers ou URL ne sont pas récupérées : un schéma qui en dépend est signalé comme invalide, avec la référence qui n’a pas pu être résolue.
Fonctionnement
L’outil valide les données avec Ajv, un validateur JSON Schema largement utilisé, et vérifie les formats avec ajv-formats. Tout s’exécute dans votre navigateur : le schéma et les données ne sont jamais téléversés.
Fonctionnalités
- Prise en charge des versions 6, 7, 2019-09 et 2020-12 de JSON Schema, sélectionnées à partir de
$schema - Toutes les erreurs, avec leur chemin, leur mot-clé et leur message
- Valeurs en échec marquées dans les données, avec défilement au clic
- Vérification des formats des adresses e-mail, des URI, des dates, des UUID, des adresses IP et d’autres formats
- Vérification du schéma selon son métaschéma
- Ligne et colonne des erreurs de syntaxe JSON
- Exécution dans votre navigateur