Ce convertisseur en ligne (JavaScript class → JSON Schema) vous aide à générer du JSON Schema à partir de modèles réels (DTOs, structs et classes) pour valider des payloads, partager des contrats et générer du mock JSON.
Étape 1 – Collez votre source JavaScript
- Collez les modèles à documenter dans l’éditeur de gauche.
- Incluez les types référencés dans le même snippet afin de générer les definitions.
- Utilisez le bouton Exemple pour charger un exemple et voir le format attendu.
Étape 2 – Sélectionnez la Type racine (si besoin)
- Si plusieurs definitions sont détectées, choisissez la racine qui correspond à votre payload d’API.
- Le schéma de sortie est construit autour de la racine sélectionnée et peut inclure des definitions supplémentaires.
Étape 3 – Vérifiez la sortie JSON Schema
- Contrôlez types, champs requis vs optionnels, et structures imbriquées d’objets/arrays.
- Surveillez
definitions et $ref lorsque vos modèles référencent d’autres modèles. - Copiez ou téléchargez le schéma pour validation, documentation ou approche schema-first.
Étape 4 – Valider ou générer du mock JSON
- Cliquez sur Générer des données mock pour ouvrir le générateur de mock avec votre schéma préchargé.
- Validez des payloads réels avec votre schéma pour détecter tôt les breaking changes.
- Si vous utilisez une composition avancée (par ex.
anyOf/oneOf/allOf), vérifiez le résultat avec un validateur complet comme Ajv.
Note sur le support des mots-clés
Les schémas générés peuvent inclure $ref et peuvent être édités pour ajouter anyOf, oneOf, ou allOf. Pour des schémas complexes, utilisez un validateur JSON Schema complet et dereferencez avant génération de mock si nécessaire.