Générateur de JSON Schema
Générer automatiquement un JSON Schema à partir de données JSON
Déduit des données d’exemple. Les schémas d’éléments de tableau reposent sur le premier élément ; vérifiez et affinez le schéma avant la validation.
Traité sur cet appareil. Votre texte n’est pas envoyé.
Générateur de JSON Schema en ligne gratuit
Notre générateur de JSON Schema analyse des exemples de données JSON et produit instantanément une définition JSON Schema valide, avec une détection précise des types, la gestion des objets imbriqués et l’inférence des éléments de tableau. Collez simplement un objet JSON, choisissez la version de draft souhaitée et obtenez un schéma utilisable pour la validation d’API, la génération de formulaires ou la documentation, sans écrire une seule ligne de schéma à la main.
L’outil prend en charge JSON Schema draft-04, draft-06 et draft-07, les versions les plus répandues de l’écosystème. Il parcourt récursivement votre structure JSON en détectant les chaînes, les nombres, les entiers, les booléens, les valeurs nulles, les objets et les tableaux. Pour les tableaux, le schéma est déduit du premier élément, ce qui garantit des définitions d’éléments exactes même pour des structures imbriquées complexes.
Des options configurables permettent d’activer les tableaux de propriétés requises, d’ajouter des descriptions provisoires pour la documentation et d’imposer additionalProperties: false pour une validation stricte. Une fois satisfait, téléchargez le résultat sous forme de fichier .schema.json ou copiez-le dans votre presse-papiers en un clic. Tout s’exécute localement dans votre navigateur : vos données ne sont jamais envoyées à un serveur.
Fonctionnalités principales
- Prise en charge de JSON Schema draft-04, draft-06 et draft-07 avec l’URI $schema correspondante
- Détection automatique des types string, number, integer, boolean, null, object et array
- Génération récursive de schémas pour les objets et tableaux profondément imbriqués
- Inférence du type des éléments de tableau à partir du premier élément
- Tableaux de propriétés « required » configurables pour contrôler la rigueur de la validation
- Génération facultative de descriptions « description » provisoires pour des schémas auto-documentés
- Option « additionalProperties: false » pour imposer des formes d’objets strictes
- Téléchargement du schéma généré sous forme de fichier .schema.json
- Copie dans le presse-papiers en un clic
- JSON d’exemple préchargé pour expérimenter rapidement
Comment utiliser le générateur de JSON Schema
- Configurer les options du schéma : Sélectionnez la version du draft, puis activez ou désactivez les tableaux required, les descriptions et additionalProperties selon vos besoins.
- Coller votre JSON : Saisissez ou collez un objet JSON d’exemple dans le panneau de saisie. Vous pouvez aussi cliquer sur « JSON d’exemple » pour charger un exemple.
- Générer le schéma : Cliquez sur « Générer le schéma » pour produire le JSON Schema dans le panneau de droite.
- Vérifier et affiner : Examinez le résultat. Ajustez les options comme les champs requis ou les descriptions, puis régénérez si nécessaire.
- Exporter le schéma : Cliquez sur « Copier » pour placer le schéma dans votre presse-papiers, ou sur « Télécharger .schema.json » pour l’enregistrer dans un fichier.
Cas d’usage
- Spécifications OpenAPI / Swagger : Générez des définitions de schéma pour les corps de requête et de réponse dans votre documentation d’API.
- Validation de requêtes côté backend : Créez des schémas pour valider les charges JSON entrantes dans Express, FastAPI, Spring Boot ou d’autres frameworks.
- Génération de formulaires côté frontend : Fournissez les schémas à des bibliothèques comme react-jsonschema-form pour générer automatiquement des formulaires d’interface à partir de modèles de données.
- Contrats de données : Définissez et partagez des contrats de données structurées entre microservices ou entre équipes frontend et backend.
- Validation de configuration : Validez les fichiers de configuration JSON dans les pipelines CI/CD pour détecter les erreurs de structure avant le déploiement.
- Planification de migration de base de données : Documentez les formes de données attendues lors de la conception de nouvelles tables ou collections.
- Autocomplétion dans l’IDE : Référencez un JSON Schema dans les paramètres de VS Code pour activer IntelliSense et la validation sur vos fichiers JSON personnalisés.
Questions fréquentes
Cet outil est-il gratuit ?
Oui, le générateur de JSON Schema est entièrement gratuit, sans inscription ni limite d’utilisation. Générez des schémas pour autant d’objets JSON que vous le souhaitez, sans frais.
Mes données sont-elles en sécurité ?
Oui. Toute la génération de schémas s’effectue dans votre navigateur. Vos données JSON ne sont jamais envoyées à un serveur, ce qui permet de l’utiliser en toute sécurité avec des charges d’API propriétaires ou des structures de données internes.
Qu’est-ce que JSON Schema ?
JSON Schema est un vocabulaire déclaratif pour annoter et valider des documents JSON. Il décrit la structure attendue, les types de données, les propriétés requises et les contraintes d’un objet JSON. Il est très utilisé dans les spécifications d’API (OpenAPI/Swagger), les bibliothèques de génération de formulaires et les outils de validation de configuration.
Quelle version du draft dois-je utiliser ?
Le draft-07 est recommandé pour la plupart des projets, car c’est la version la plus largement prise en charge par les bibliothèques de validation et les outils. N’utilisez le draft-04 ou le draft-06 que si votre chaîne d’outils exige expressément une version plus ancienne.
Puis-je modifier le schéma généré ?
Le schéma généré est un point de départ. Après l’avoir téléchargé ou copié, vous pouvez ajouter manuellement des contraintes comme minLength, maximum, des valeurs enum ou des regex pattern, qui ne peuvent pas être déduites des seules données d’exemple.
Gère-t-il les tableaux à types mixtes ?
Le générateur déduit le type des éléments d’un tableau à partir du premier élément. Si votre tableau contient des types mixtes, vous devrez peut-être ajuster manuellement la définition de items en schéma oneOf ou anyOf après la génération.
Astuces et bonnes pratiques
- Fournir des données d’exemple représentatives : Incluez tous les champs possibles dans votre JSON d’exemple pour que le schéma capture la structure complète.
- Activer les tableaux required : Activez l’option « required » pour imposer les champs obligatoires lorsque vous utilisez le schéma pour la validation.
- Ajouter les descriptions plus tard : Activez les descriptions provisoires pendant la génération, puis remplacez-les par une vraie documentation avant de partager le schéma.
- Utiliser additionalProperties: false pour les API strictes : Cela empêche les clients d’envoyer des champs inattendus qui pourraient causer des problèmes en aval.
- Valider après la génération : Testez votre schéma sur plusieurs charges d’exemple avec un validateur JSON Schema pour vous assurer qu’il couvre les cas limites.
- Versionner vos schémas : Stockez les fichiers de schéma dans le contrôle de version, avec le code de votre API, pour suivre les changements au fil du temps.