Générateur de schéma JSON
Générer automatiquement un schéma JSON à partir de données JSON
Entrée JSON
Schéma généré
Qu'est-ce qu'un générateur de schéma JSON ?
JSON Schema décrit la structure des données JSON : champs requis, types, valeurs autorisées, formats. Un générateur de schéma déduit un schéma à partir d'un exemple JSON. Vous collez des données d'exemple et il produit un schéma qui décrit cette structure. Vous pouvez ensuite utiliser le schéma pour valider d'autres JSON ou documenter des API.
Cet outil s'exécute dans votre navigateur. Collez votre JSON et il génère un brouillon de schéma JSON. Rien n'est envoyé à un serveur.
Comment utiliser cet outil
Coller un exemple JSON
Collez du JSON qui représente la structure que vous souhaitez décrire. Utilisez Exemple ou Importer si nécessaire. Le générateur déduit les types à partir des valeurs (string, number, boolean, array, object).
Examiner le schéma
Le panneau droit affiche le schéma généré. Il peut inclure type, properties, required et des schémas imbriqués pour les objets. Vous pouvez le modifier manuellement si nécessaire.
Copier ou télécharger
Utilisez <strong>Copier</strong> ou <strong>Télécharger</strong> pour obtenir le schéma. Pour valider du JSON contre un schéma, utilisez le Validateur JSON ou une bibliothèque comme <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a>.
Exemples de schéma JSON
Générer un schéma à partir d'un exemple JSON. Exemple à thème télécom :
Entrée JSON
Schéma généré
Quand utiliser un schéma généré
Les schémas générés sont un point de départ. Ils capturent la structure de vos données d'exemple mais peuvent être trop stricts ou trop souples. Vous pourriez avoir besoin d'ajouter des tableaux required, d'ajuster les types ou d'ajouter enum pour les valeurs autorisées. La documentation JSON Schema explique le vocabulaire complet. Pour la documentation d'API, des outils comme OpenAPI peuvent référencer JSON Schema.
Questions fréquentes
Puis-je valider du JSON avec ce schéma ?
Cet outil ne fait que générer des schémas. Pour valider, utilisez le Validateur JSON ou une bibliothèque comme <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a> dans votre code.
Et si mon JSON a des formes différentes ?
Le générateur déduit à partir de l'exemple que vous fournissez. Si votre JSON peut avoir plusieurs formes (ex. champs optionnels), le schéma pourrait nécessiter des modifications manuelles. Utilisez oneOf ou anyOf pour les variantes.
Mes données sont-elles envoyées quelque part ?
Non. La génération s'exécute dans votre navigateur.
Quel brouillon JSON Schema est utilisé ?
L'outil peut utiliser draft-07 ou draft-2020-12. Vérifiez le schéma généré pour $schema pour voir la version. La spécification JSON Schema contient les détails.
Puis-je utiliser cela pour les réponses API ?
Oui. Collez une réponse API typique. Le schéma généré décrit cette structure. Vous pouvez ensuite l'utiliser dans OpenAPI/Swagger ou pour la documentation.
Outils connexes
En savoir plus sur json-schema.org et JSON Schema learn. Pour la validation dans le code, voir Ajv. Pour le JSON, voir json.org, MDN et RFC 8259. Pour la documentation d'API, voir OpenAPI.