
JSON Schema : valider des données en ligne (Draft 2020-12)
Testez payloads API et fichiers config contre un JSON Schema Draft 2020-12 — erreurs par chemin JSON Pointer, dans le navigateur.
Valider des données JSON contre un schéma
Un JSON valide n'est pas forcément valide pour votre API. Un payload peut être analysé correctement. Il peut pourtant manquer un champ requis, envoyer un mauvais type ou violer une contrainte format. Ces bugs n'apparaissent souvent qu'en tests d'intégration ou dans les journaux de production. JSON Schema répond à une autre question que la vérification de la syntaxe : cette instance respecte-t-elle le contrat ? Le validateur JSON Schema en ligne de FastMinify exécute la validation Draft-07 et 2020-12 dans deux éditeurs Monaco (schéma et instance), entièrement dans votre navigateur. Si la syntaxe est douteuse, commencez par le validateur JSON. Si le contrat vit dans OpenAPI, utilisez validate-openapi. Le hub outils API regroupe les outils de conversion de schémas et de lint OpenAPI.
Limites honnêtes et schémas maintenables
Un résultat vert signifie que l'instance respecte le schéma collé, pas que toute la plateforme d'API est conforme.
$ref externes, y compris en https://, ne sont jamais résoluesLes schémas qui passent proprement dans le navigateur résistent mieux à la CI et à la génération de SDK.
$schema dans les fichiers partagés pour éviter les hypothèses implicites sur 2020-12additionalProperties: false seulement pour des objets fermés délibérémentexamples dans OpenAPI et collez-les comme instances pendant les relecturesdescription, les valeurs dépréciéesLes contrôles dans le navigateur économisent des minutes de pipeline, et la politique de l'organisation reste en CI.
Syntaxe JSON vs validation JSON Schema
Ne changez pas d'outil en plein débogage : chacun cible un type d'échec distinct.
FastMinify détecte le draft d'après $schema quand il est présent ; sans $schema, c'est 2020-12 par défaut.
https://json-schema.org/draft/2020-12/schemahttp://json-schema.org/draft-07/schema#components.schemasEn cas d'échec, Ajv indique où l'instance a enfreint le schéma, ce qui est précieux sur les gros payloads d'API.
instancePath pointe vers la valeur en échec (style JSON Pointer)required, type, format, …)required → chemin / ou propriétés manquantesValider du JSON contre un schéma, pas à pas
Le validateur JSON Schema propose deux éditeurs : Schéma et Instance. Collez du JSON dans chaque champ. Le YAML n'est pas accepté dans l'éditeur de schéma, qui lit uniquement du JSON. La limite est de 512 KiB par champ.
Le mode Strict active strict: true d'Ajv à la compilation du schéma : les mots-clés inconnus et les autres motifs non stricts échouent avant la validation de l'instance.
components.schemas d'OpenAPILe client mobile plante sur une nouvelle forme de champ. La réponse est du JSON valide, mais elle casse le schéma publié.
Confirmez la syntaxe JSON
Collez la réponse dans json-validator. Si la syntaxe échoue, réparez-la avant la validation du schéma.
Collez le schéma et l'instance
Ouvrez json-schema-validator. Collez le schéma de référence (export OpenAPI ou registre de schémas) et la réponse de préproduction.
Lisez les erreurs instancePath
Corrigez l'API ou mettez le schéma à jour avec un plan de dépréciation. Validez de nouveau après le déploiement. Vous pouvez aussi comparer les payloads de préproduction et de production avec diff.
L'équipe partage une configuration JSON validée en CI avec JSON Schema, et vous voulez un contrôle local rapide sans cloner le pipeline.
Chargez le schéma depuis le dépôt
Copiez le JSON du schéma. Il doit être autonome, car les $ref externes ne sont pas résolus dans le navigateur.
Validez votre modification
Collez la configuration modifiée comme instance. Activez Strict si le schéma est écrit pour une relecture stricte.
Enchaînez avec les outils YAML si besoin
Les configurations sont souvent en YAML. Convertissez-les avec yaml-to-json, vérifiez la syntaxe, puis validez l'instance JSON contre le schéma.
OpenAPI, components.schemas et conversion
Les équipes REST publient souvent leurs formes dans components.schemas d'OpenAPI, tandis que les registres de schémas stockent des fichiers autonomes. Le validateur accepte l'un comme l'autre une fois extrait en JSON. Le déroulé : validate-openapi pour l'enveloppe de la spécification, extraction du schéma, puis json-schema-validator pour vérifier le payload contre ce schéma. Voir notre guide validation OpenAPI et le guide lint & format pour le côté spécification du contrat.
Quand la source du schéma est le fichier OpenAPI, changez de format sur le hub sans CLI locale. Utilisez openapi-to-json-schema pour extraire un schéma des components OpenAPI. Utilisez json-schema-to-openapi pour envelopper un schéma autonome dans une coque OpenAPI à importer dans un portail.
La validation dans le navigateur accélère le retour d'information, la CI garde les suites de régression. Collez des instances représentatives : cas nominal, valeurs nulles limites et bornes des enums. Documentez le draft dans $schema, à côté de chaque fichier de schéma partagé dans le dépôt git.
Échecs de validation fréquents
Ces cas reviennent sans cesse dans les tickets de support et les jobs de CI instables.
required manquante : instancePath désigne le parent ou la racine /type, par exemple une chaîne là où un entier est attendu (fréquent après la sérialisation d'un formulaire)additionalProperties: false attrape les champs en trop venus d'une erreur de versionnage de l'APIformat comme date-time, email ou uuid (via ajv-formats)enum : codes de statut ou de région non documentés dans le payloadLe mode Strict et les drafts non pris en charge apparaissent ici avant la validation de l'instance.
$schema non prise en charge : passez à Draft-07 ou 2020-12$ref externe est une erreur bloquante : intégrez ou regroupez d'abord les références en localConclusion
La validation JSON Schema comble l'écart entre un JSON analysable et des données d'API fiables. Commencez par la syntaxe si besoin, puis validez les instances contre des schémas Draft-07 ou 2020-12, avec des erreurs instancePath claires, en local avant la CI. Extrayez les schémas depuis OpenAPI quand le contrat vit dans la spécification, et gardez des limites honnêtes sur les références, les drafts et la taille.
Validez votre instance JSON contre un schéma maintenant
Articles connexes

Collez un token et un JWKS pour vérifier une signature RS256, ES256 ou HS256 dans le navigateur. Choix par kid, erreurs mesurées, claims à contrôler.

HTTP/2 et HTTP/3 changent le trajet des fichiers, pas leur poids. Mesures de taille, de compilation et de bundling : ce que la minification apporte encore.

Convertissez un epoch Unix en date lisible et inversement, distinguez secondes et millisecondes, et évitez les pièges de fuseau, de JWT et de changement d’heure.