Générateur Ruby Class → JSON Schema

Entrée Code Ruby

Chargement de l’éditeur…

Sortie JSON Schema

Paramètres

Choisissez quelle classe doit être considérée comme racine du JSON Schema.

Le parsing s’exécute entièrement dans votre navigateur. Votre code ne quitte jamais la page.

Collez vos classes Ruby pour produire du JSON Schema instantanément.

Support des structures imbriquées et definitions ; tout s’exécute localement dans le navigateur.

Comment convertir classes Ruby en JSON Schema — guide pas à pas

Ce convertisseur en ligne (Ruby 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.

  1. Étape 1 – Collez votre source Ruby

    • 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.
  2. Étape 2 – Sélectionnez la Classe 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.
  3. É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.
  4. É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.

Outils liés à JSON Schema et à la génération de code

Utilisez ces outils pour valider des schémas, générer des payloads mock, formater des exemples JSON et synchroniser code et contrats.

Questions fréquentes

Quel Ruby est supporté ?

Classes avec attributs courants et structures imbriquées. Collez plusieurs classes liées pour générer des definitions.

Comment les types et optionnels sont-ils gérés ?

Le mapping tente d’inférer les types depuis des déclarations et patterns courants. Les champs optionnels sont marqués comme non requis.

Puis-je choisir la classe racine ?

Oui. Si plusieurs classes sont détectées, choisissez la racine dans les settings sans recharger.

Comment générer des données mock ?

Après génération du schéma, utilisez "Générer des données mock" pour ouvrir le Générateur de Mock avec le schéma préchargé.

Générateur Ruby Class → JSON Schema | JSONSwiss