Des exemples au contrat
Essayez l’exemple. Choisissez plusieurs échantillons seulement si chaque élément du tableau extérieur représente un document distinct.
Traitement dans ce navigateur, sans envoi ni stockage des échantillons.
1 exemples · 7 propriétés · 0 enums · 0 omis
Le Générateur JSON Schema fournit un point de départ quand la documentation se résume à quelques réponses d’API. Une réponse complète ne prouve pas que les suivantes contiendront les mêmes clés. Des exemples contrastés rendent ces écarts visibles.
Une clé absente et une valeur null ne signifient pas la même chose. required porte sur la présence de la propriété ; son type porte sur sa valeur. Vous pouvez donc rendre une propriété obligatoire tout en autorisant null.
Le Générateur JSON Schema examine tous les éléments d’un tableau à la même position structurelle. Une clé manquante quitte les champs requis communs, tandis qu’un null explicite s’ajoute au type. Les objets de chemins différents restent séparés.
Passer en édition arrête la génération automatique. Une nouvelle génération propose un candidat séparé, sans effacer vos ajouts. Appliquer remplace un schéma ; Annuler l’action restaure ensemble saisie, options et résultat.
En document unique, le tableau reste le type racine. En plusieurs échantillons, ses éléments sont des documents indépendants à fusionner. Pour comparer des documents qui sont eux-mêmes des tableaux, utilisez un tableau de tableaux.
Les champs requis communs apparaissent dans chaque objet à cette position. Tout rendre obligatoire peut rejeter un exemple initial incomplet. Autoriser null ne retire aucune propriété de required.
Modifier la saisie ou les options désactive immédiatement l’export. La génération automatique attend 350 ms ; en manuel, utilisez Ctrl/Cmd+Entrée. Après retouche, une nouvelle proposition doit être relue puis appliquée.
Le Générateur JSON Schema propose Draft 7, 2019-09 et 2020-12. Les formes utilisées pour type, properties, required, enum et items sont communes. Le choix change donc l’URI $schema, sans convertir un schéma existant complexe.
1.0 et 100e-2 sont des integer selon leur valeur mathématique. La présence d’une fraction conduit à number. Les grands nombres conservent leur écriture ; les valeurs égales d’un enum sont dédupliquées sans passer par Number.
L’option est désactivée au départ. Chaque position scalaire peut recevoir au plus 20 valeurs distinctes, y compris le null ajouté. Au-delà, l’enum entier est omis et compté dans l’état ; aucun sous-ensemble trompeur n’est conservé.
Le schéma inféré reste modifiable pour ajouter les contraintes métier. Les tableaux vides donnent items: {} faute d’éléments à observer. L’éditeur contrôle seulement la syntaxe JSON et la forme de la racine, pas toute la sémantique du schéma.
Il doit être relu. Un ensemble d’exemples ne démontre pas tous les cas autorisés ou interdits. Complétez les règles métier, puis testez des données valides et invalides avec le validateur de votre projet.
Par défaut, seules les propriétés présentes dans tous les objets à cette position sont requises. null compte comme une présence. Les options Tous requis et Aucun requis permettent de choisir une politique différente.
Ces drafts diffèrent notamment pour les tuples et certains mots-clés. Ici, seule leur partie commune est générée ; le choix modifie la déclaration $schema. Sélectionnez la version comprise par votre validateur.
Ici, aucune date n’est détectée automatiquement : elle reste string. Si le contrat exige date ou date-time, ajoutez format manuellement et vérifiez son traitement dans votre environnement.
Seulement si vous activez enum. Les positions scalaires peuvent alors recueillir jusqu’à 20 valeurs distinctes. Si null porte le total à 21, l’enum est également omis. Cette option peut restreindre abusivement un simple exemple.
Un résultat d’inférence à vérifier ?
Utilisez le Générateur JSON Schema avec des réponses variées, puis ajoutez les exigences métier après examen des champs absents et des valeurs autorisées.