JSON Swiss

JSON Swiss

Générateur Rust Struct → JSON Schema

Entrée Code Rust

1

Sortie JSON Schema

Paramètres

Choisissez quel struct doit être considéré comme racine du JSON Schema.

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

Collez vos structs Rust pour produire du JSON Schema instantanément.

Prend en charge Option<T>, Vec<T>, HashMap/BTreeMap, les attributs serde rename et les structs imbriquées.

Comment convertir structs Rust en JSON Schema — guide pas à pas

Ce convertisseur en ligne (Rust struct → 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 Rust

    • 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 Struct 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.

Générateur de données mock (JSON Schema)

Générez du JSON d’exemple depuis votre schéma pour tests, fixtures et documentation.

Validateur de JSON Schema

Validez du JSON avec des mots-clés courants et repérez vite les écarts.

JSON vers structures Rust

Générez des types et modèles Rust depuis des exemples JSON.

Générateur JSON → JSON Schema

Construisez un schéma depuis des exemples JSON représentatifs pour compléter l’approche model-first.

Bibliothèque de JSON Schema

Explorez des exemples et patterns pour objets, arrays, enums et contraintes.

Formateur JSON

Nettoyez vos exemples JSON avant validation ou partage de docs.

Questions fréquentes

Quel Rust est supporté ?

Les structs nommées avec champs publics, structs imbriquées, Option<T>, Vec<T>, tableaux, HashMap/BTreeMap, références et durées de vie (ignorées pour le schéma) sont prises en charge, ainsi que les attributs serde comme #[serde(rename = "...")]. Les enums sont ignorées pour le moment : collez les structs qui représentent vos payloads JSON.

Comment les types Rust sont-ils mappés ?

Les types primitifs comme String, bool, les entiers, les flottants, chrono::DateTime et uuid::Uuid deviennent des primitifs JSON Schema. Vec<T> devient un tableau, HashMap<string, T> devient un objet et Option<T> marque automatiquement le champ comme facultatif.

Puis-je inclure plusieurs structs ?

Oui. Collez plusieurs types et sélectionnez le struct racine dans les settings pour générer à partir du bon root.

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

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