Explorateur de schéma GraphQL

Chargez le schéma et collez une opération pour voir les champs racine exposés, vérifier ses sélections et obtenir un modèle de variables prêt à compléter. Tout s’exécute dans le navigateur ; ces contrôles partiels ne remplacent pas la validation complète de GraphQL.

Fonctionne localement dans votre navigateur
Toute l’analyse reste dans ce navigateur. Rien n’est téléversé ni envoyé à une API.
Schéma ou introspection JSON
Opération à valider

Il s'agit d'un assistant de schéma et de requête. Il n'envoie pas l'opération, les variables ou le schéma à un point de terminaison GraphQL.

Résumé du schéma
  • Collez un schéma pour inspecter les types, les champs racine et une opération locale.
Modèle de variables
Types et champs racine
  • Collez un schéma pour inspecter les types, les champs racine et une opération locale.

Valider la structure GraphQL avant d'utiliser un client API

L'explorateur identifie les structures SDL et d'introspection courantes, vérifie les champs racine et crée un objet variables de départ. Cela ne remplace pas la validation GraphQL côté serveur.

Comment utiliser « Explorateur de schéma GraphQL »

L’explorateur lit un schéma GraphQL au format SDL ou une réponse JSON d’introspection et liste tous les types trouvés ainsi que les types racine définis par le schéma.

Collez une opération sous le schéma pour vérifier ses sélections racine face au type racine correspondant et préparer un modèle de variables. L’analyse s’exécute dans le navigateur ; rien n’est envoyé à un point de terminaison.

  1. Collez le SDL ou le JSON d’introspection dans le panneau de gauche, ou chargez un fichier .graphql, .json ou .txt.
  2. Collez dans le panneau de droite la requête, la mutation ou la souscription à vérifier.
  3. Cliquez sur Inspecter le schéma et la requête : le résumé compte les types et les champs racine, et les constats marquent chaque sélection racine comme présente ou absente.
  4. Copiez le modèle de variables et renseignez de vraies valeurs avant d’exécuter l’opération dans votre client API.

Contexte et précision

Ce que couvre la vérification

Le schéma est lu par un analyseur qui comprend les descriptions, commentaires, directives et valeurs par défaut : les types et champs résistent donc aux accolades présentes dans les valeurs par défaut ou les descriptions, et les valeurs d’enum ne sont pas confondues avec leurs directives.

De l’opération collée, l’explorateur retient la première requête, mutation ou souscription et ignore les définitions de fragments. Ses sélections de premier niveau — alias compris — sont comparées aux champs du type racine correspondant.

Types racine et sélections

Un schéma définit ses racines dans un bloc schema { ... } ou via les noms par défaut Query, Mutation et Subscription. Le bloc est prioritaire : un type nommé Query n’est racine que si le bloc associe query à lui.

Les spreads de fragment et les fragments en ligne ne comptent pas comme des champs. Une requête est vérifiée contre la racine de requête, une mutation contre Mutation et une souscription contre Subscription ; si ce type racine manque, l’explorateur le signale au lieu d’annoncer un champ erroné.

Modèle de variables

Chaque variable de l’opération reçoit une valeur d’exemple : String et ID deviennent « example », Int et Float 0, Boolean false, les enums prennent leur première valeur et les objets d’entrée sont développés avec leurs propres champs.

Les types liste produisent des tableaux ([ID!]! devient ["example"]) ; les entrées trop imbriquées reviennent à « example » après trois niveaux. Le modèle est un point de départ, jamais téléversé ni exécuté.

Outils récents :