Générateur C# Class → JSON Schema

Entrée Code C#

Chargement de l’éditeur…

Sortie JSON Schema

Paramètres

Choisissez quelle classe/record 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 modèles C# pour produire du JSON Schema instantanément.

Support des classes, records, collections, objets imbriqués et nullables.

Comment convertir classes et records C# en JSON Schema — guide pas à pas

Ce convertisseur en ligne (C# 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 C#

    • 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 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.
  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 C# est supporté ?

Classes et records avec propriétés publiques, types primitifs, arrays, listes, objets imbriqués et enums. Des attributs comme JsonPropertyName peuvent aider à aligner les noms avec votre sérialiseur.

Comment gérer les nullables et optionnels ?

Les champs nullables et propriétés optionnelles sont marqués comme optionnels dans le schéma. List<T> ou Dictionary<string, T> deviennent des arrays/objects selon le cas.

Puis-je convertir plusieurs types à la fois ?

Oui. Collez plusieurs types liés et sélectionnez le type racine dans les settings. Tout est traité dans votre navigateur.

Comment obtenir 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 C# Class → JSON Schema | JSONSwiss