Convertir JSON en schéma GraphQL — Numio

Quand l’utiliser

• Préparer les types d’un wrapper GraphQL autour d’un endpoint REST existant à partir de l’une de ses réponses.
• Obtenir un schéma de départ pour un serveur mock ou un prototype schema-first à partir de données d’exemple.

Mode d’emploi

1. Collez dans l’éditeur de gauche un objet JSON, ou un tableau d’objets fusionnés en un seul type racine, ou utilisez le bouton de chargement de fichier pour ouvrir un fichier UTF-8.
2. Vérifiez les types générés : les noms viennent des clés (posts devient Posts) et les scalaires sont associés à String, Int, Float ou Boolean.
3. Copiez le SDL, puis ajoutez ! aux champs obligatoires, passez les champs id en ID et renommez AutogeneratedMainType.

{
  "id": "u_1",
  "name": "Ada",
  "age": 36,
  "score": 9.5,
  "nickname": null,
  "tags": ["math"],
  "address": { "city": "London" },
  "posts": [{ "id": 7, "title": "Notes" }]
}

type AutogeneratedMainType {
  id: String
  name: String
  age: Int
  score: Float
  nickname: String
  tags: [String]
  address: Address
  posts: [Posts]
}

type Address {
  city: String
}

type Posts {
  id: Int
  title: String
}

Détails et limites

Les champs sont fusionnés sur tous les éléments du tableau. null et les tableaux vides deviennent String et [String] ; Int mélangé à Float donne Float, et les autres conflits retombent sur String.

Les noms de types viennent des clés (posts devient Posts). Si une même clé contient des objets de formes différentes, le suivant est nommé d’après son parent (par exemple AB) au lieu d’écraser le précédent.

Aucun ! (non null), ID, type Query ni type input n’est généré. Les entiers hors de la plage 32 bits sont typés Float, car le Int de GraphQL est sur 32 bits.

S’exécute dans votre navigateur et le résultat est formaté avec Prettier ; un JSON invalide affiche l’erreur d’analyse.

FAQ

Outils associés

Spécifications et références

• GraphQL specification: Schema and types