Décrivez la forme de vos données avec JSON Schema, transformez les accords verbaux en validation exécutable, et laissez-le piloter à son tour les types TypeScript et la génération de formulaires.
7 articlesLes mots-clés sont nombreux, mais une douzaine seulement servent au quotidien. Bien maîtriser type/properties/required/$ref, bien gérer les messages d'erreur, et vous couvrez quatre-vingts pour cent des cas réels.
Types et schémas couvrent chacun un segment : l'un à la compilation, l'autre à l'exécution. La question n'est pas lequel choisir, mais comment garder les deux synchronisés automatiquement.
Les schémas générés bloquent souvent des données valides. Comprenez pourquoi des échantillons plus riches produisent des schémas pires, puis le workflow : échantillonnage multi-enregistrements, complétion sémantique, localisation des erreurs.
$ref résout la réutilisation, allOf et oneOf résolvent la composition, et c'est en empilant les deux que ça casse. Couvre $id, $defs, les conditions, la récursion, le regroupement et le débogage.
Un validateur émet des erreurs lisibles par machine ; l'utilisateur veut savoir quel champ de saisie est faux. Couvre le tableau errors d'Ajv, instancePath contre schemaPath, le regroupement et la rédaction.
Une validation réussie ne garantit pas des données propres. Pydantic ignore les champs inconnus par défaut, Zod les supprime, Ajv les laisse passer — les paramètres hallucinés et les clés mal orthographiées traversent en silence. Cet article montre les trois formes d'acceptation silencieuse et donne les recettes complètes : fermer les objets, contrôler la coercition, serrer chaque niveau d'imbrication.
Un schéma ne s'achève pas à l'écriture — c'est là que commence la dégradation. Une coquille assoupit silencieusement la validation, un refactoring casse toutes les fixtures. Ce guide présente un dispositif de test de contrat exploitable : fixtures positifs, négatifs et instantanés, lint du schéma lui-même, compilation unique réutilisée, et quatre portes de CI qui transforment la casse du contrat en build rouge.
