Générateur de Schéma GraphQL depuis JSON en ligne
Transformez un échantillon JSON en définitions de type GraphQL SDL, directement dans votre navigateur. Rien de ce que vous collez n'est envoyé.
Le Générateur de Schéma GraphQL depuis JSON fonctionne entièrement dans votre navigateur. L'échantillon JSON que vous collez et le SDL produit ne sont jamais envoyés à ArrayKit.
Ouvrir le Convertisseur JSON vers TypeScript
À propos de JSON vers GraphQL
JSON to GraphQL Schema transforme un échantillon JSON en document GraphQL SDL prêt à l'emploi. Collez un objet et l'outil déduit un bloc `type Root`, en associant les nombres à Int ou Float, les chaînes à String, les booléens à Boolean, et toute clé nommée id au scalaire ID. Les tableaux deviennent des types de liste non nuls comme [String!]!, et les objets imbriqués sont extraits dans leurs propres types nommés (PascalCase à partir de la clé du champ) pour que le schéma reste lisible plutôt que profondément imbriqué. C'est utile lorsque vous prototypez une API GraphQL à partir d'une réponse d'exemple, migrez un endpoint REST, ou esquissez des resolvers avant même que le backend existe. Définissez un nom de type racine personnalisé, copiez le SDL généré ou téléchargez-le en tant que fichier .graphql. Tout s'exécute localement dans votre navigateur — votre échantillon JSON n'est jamais envoyé où que ce soit.
Fonctionnalités
- Déduit un bloc `type` GraphQL complet à partir de n'importe quel objet JSON
- Associe les nombres à Int ou Float selon qu'il s'agit d'entiers ou non
- Reconnaît un champ "id" et le type comme le scalaire ID de GraphQL
- Transforme automatiquement les objets imbriqués en leurs propres types nommés
- Les tableaux deviennent des types de liste non nuls, par ex. tags: [String!]!
- Déduplique les noms de types imbriqués répétés dans le schéma
- Champ de nom de type racine personnalisé, par défaut "Root"
- Copiez le SDL ou téléchargez-le en fichier .graphql, entièrement côté client
Comment utiliser JSON vers GraphQL
- Collez un objet JSON dans le panneau de saisie, ou chargez l'exemple
- Définissez éventuellement un nom de type racine
- Vérifiez le SDL GraphQL généré à droite
- Copiez le schéma ou téléchargez-le en fichier .graphql
Exemple
Entrée
{"id":1,"name":"Ada"}
Sortie
type Root {
id: ID!
name: String!
}
Le champ id est typé comme ID, et name devient un String non nul.
Erreurs courantes et dépannage
- Chaque champ est requis (String!) mais certaines réponses omettent cette clé. — Incluez un échantillon représentatif avec `null` pour les champs qui peuvent manquer — le Générateur de Schéma GraphQL depuis JSON rend les valeurs nulles ou absentes nullables au lieu d'ajouter !.
- Un champ de type tableau a produit [String]! au lieu d'une liste typée. — Fournissez au moins un élément non nul dans le tableau d'exemple pour que l'outil puisse déduire son type d'élément ; les tableaux vides utilisent [String] par défaut.
- Deux objets imbriqués différents ont généré le même nom de type. — Renommez l'une des clés JSON avant de coller, ou renommez le type dans le SDL généré ensuite — le générateur déduplique par nom, donc des clés identiques partagent un type.
- Le bandeau affiche "Invalid JSON" et aucun schéma n'apparaît. — Vérifiez s'il y a une virgule superflue, une clé sans guillemets ou des guillemets simples — l'outil exige du JSON strict, et le message d'erreur indique la ligne et la colonne à corriger.
Foire aux questions
- Que produit le Générateur de Schéma GraphQL depuis JSON ?
- Il lit un échantillon JSON et génère du GraphQL SDL — un ou plusieurs blocs `type` avec des noms de champs et des types scalaires, de liste ou d'objet déduits — que vous pouvez insérer directement dans un fichier de schéma GraphQL.
- Comment décide-t-il entre Int, Float, ID et String ?
- Les nombres entiers deviennent Int et les décimaux Float ; tout champ littéralement nommé "id" est typé comme le scalaire ID de GraphQL ; le texte devient String et true/false devient Boolean.
- L'outil JSON vers GraphQL gère-t-il les objets et tableaux imbriqués ?
- Oui. Les objets imbriqués deviennent leur propre type GraphQL nommé (PascalCase à partir de la clé du champ), et les tableaux deviennent des types de liste non nuls comme [String!]!, en déduisant le type d'élément à partir du premier élément.
- Puis-je renommer le type racine généré ?
- Oui. Utilisez le champ de nom de type racine — il vaut "Root" par défaut, mais vous pouvez le régler sur ce que vous voulez, comme "User" ou "Product", avant de copier le schéma.
- Mon échantillon JSON est-il envoyé quelque part ?
- Non. Le Générateur de Schéma GraphQL depuis JSON fonctionne entièrement dans votre navigateur. Le JSON que vous collez et le SDL généré ne quittent jamais votre appareil.
- Que se passe-t-il avec un JSON invalide ou mal formé ?
- L'outil affiche un bandeau d'erreur nommant le problème et, si possible, la ligne et la colonne, plutôt que de générer un schéma cassé.
Outils associés
- JSON vers TypeScript — Génère des interfaces TypeScript à partir d’un échantillon JSON.
- JSON vers Zod — Générez un schéma Zod à partir d’un exemple JSON, avec les types inférés.
- JSON vers Pydantic — Générez des classes de modèle Pydantic v2 à partir d’un exemple JSON.
- JSON vers code — Génère des types Go, Rust, Python, Java, Kotlin, C# et TypeScript à partir de JSON.
- Formateur GraphQL — Met en forme ou minifie les requêtes et schémas GraphQL, valide la syntaxe et extrait les opérations.
- JSON Schema — Générez un JSON Schema depuis un échantillon ou validez un document avec chaque erreur détaillée.
Tous les outils ArrayKit