Points clés
- 01Alimenté par Ajv, la bibliothèque de validation de schéma JSON JavaScript la plus largement utilisée — ce qui passe ici passe dans Node.js, Fastify et la plupart des chaînes d'outils JS.
- 02Signale chaque erreur de validation à la fois (mode allErrors), pas seulement la première défaillance.
- 03Chaque erreur inclut le chemin JSON Pointer vers le champ défaillant pour une navigation rapide.
- 04Le schéma et les données s'exécutent entièrement dans votre navigateur — rien n'est téléchargé.
Pourquoi valider JSON par rapport à un schéma ?
JSON Schema est le moyen standard de décrire la structure d'un document JSON — les champs obligatoires, les types autorisés, les contraintes de valeur, les structures d'objets imbriqués. Valider par rapport à un schéma avant qu'une charge utile ne soit mise en production détecte les incompatibilités de type, les champs obligatoires manquants et les violations de contrainte tôt, quand il est peu coûteux de les corriger.
Les cas d'usage les plus courants sont le test des corps de requête et de réponse d'API, la validation des fichiers de configuration, la vérification des objets d'exemple OpenAPI et la vérification des exportations de données par rapport à une structure connue. Le validateur de Handytool utilise Ajv — la bibliothèque JSON Schema JavaScript de facto, utilisée dans Node.js lui-même — donc les résultats ici correspondent à ce que votre backend verra.
Comment valider JSON par rapport à un schéma
- 01
Collez votre schéma JSON
Collez le schéma dans le panneau de gauche. Il peut s'agir d'un schéma Draft 7, 2019-09 ou 2020-12 avec type, properties, required, items, anyOf, allOf — n'importe quel mot-clé standard supporté par Ajv.
- 02
Collez vos données JSON
Collez le document de données que vous souhaitez valider dans le panneau de droite. C'est l'instance — un corps de requête API, un objet de configuration, un enregistrement d'export ou un seul exemple de votre spec OpenAPI.
- 03
Cliquez sur Valider
Ajv exécute la validation avec allErrors: true, ce qui signifie qu'il collecte chaque défaillance plutôt que de s'arrêter à la première.
- 04
Consultez la liste des erreurs
Chaque erreur affiche le chemin JSON Pointer vers la valeur défaillante (par exemple /user/email), le mot-clé défaillant (type, required, minimum) et un message lisible par l'homme. Corrigez chacun et revalidez.
Ce que les développeurs valident avec JSON Schema
- 01Corps de requête API REST — confirmez qu'une charge utile correspond à la forme attendue du point de terminaison avant d'envoyer.
- 02Objets d'exemple de spec OpenAPI — validez chaque exemple par rapport au composant de schéma en ligne.
- 03Fichiers de configuration — assurez-vous que les clés obligatoires sont présentes et que les valeurs sont du bon type.
- 04Enregistrements de pipeline de données — détectez la dérive structurelle entre les producteurs et les consommateurs de données.
- 05Charges utiles de soumission de formulaire — testez que la validation frontend reflète les contraintes du schéma backend.
- 06Corps de webhook tiers — confirmez que le schéma documenté correspond à la charge utile réelle.
Validation privée, aucun serveur requis
Ajv s'exécute entièrement dans votre navigateur. Ni le schéma ni les données ne sont envoyés à aucun serveur — vous pouvez valider en toute sécurité les schémas qui décrivent les structures de données internes et les objets de données qui contiennent des valeurs de champs sensibles.
Le validateur prend en charge les brouillons de schéma JSON 6, 7, 2019-09 et 2020-12. Le brouillon le plus courant dans la nature est le Draft 7, qui couvre tous les mots-clés courants : type, properties, required, items, minimum, maximum, pattern, enum, anyOf, allOf, oneOf, not et $ref.
FAQ du validateur de schéma JSON
Quels brouillons de schéma JSON sont pris en charge ?
Ajv prend en charge les brouillons 6, 7, 2019-09 et 2020-12. Le Draft 7 est le plus courant dans les bases de code existantes et couvre tous les mots-clés standard.
Pourquoi mon schéma $ref ne se résout-il pas ?
Les URL $ref externes ne sont pas récupérées dans cet outil réservé au navigateur. Intégrez tous les schémas référencés en utilisant $defs et des pointeurs JSON locaux comme #/$defs/MyType.
Mon schéma ou mes données sont-ils téléchargés sur un serveur ?
Non. Ajv s'exécute entièrement dans votre navigateur — le schéma et les données restent sur votre appareil.
Puis-je utiliser ceci pour valider une spec OpenAPI 3 ?
Vous pouvez valider les composants de schéma individuels et les objets d'exemple. La validation de l'ensemble du document OpenAPI nécessite un validateur OpenAPI dédié qui comprend le méta-schéma de la spec.
Pourquoi vois-je plusieurs erreurs au lieu de juste la première ?
Le validateur est configuré avec allErrors: true, ce qui fait qu'Ajv collecte chaque défaillance plutôt que de s'arrêter à la première. C'est intentionnel — vous pouvez corriger tous les problèmes en une seule passe plutôt que de faire des tentatives de validation répétées.