Générateur de requêtes GraphQL

Le Constructeur de Requêtes GraphQL est un outil en ligne gratuit qui permet de construire visuellement des requêtes, mutations et abonnements GraphQL avec des arbres de champs dynamiques, des variables, des fragments et une sortie en direct. Il fonctionne entièrement dans votre navigateur, sans installation ni inscription.

Query, Mutation et Subscription. Le constructeur adapte la syntaxe selon le type d'opération.

Définissez des variables typées ($userId: ID!) dans la section Variables et référencez-les dans les arguments. Les fragments définissent des sélections de champs réutilisables sur un type.

Oui, côté client, sans inscription et sans serveur.

Tout à fait. Le Constructeur de Requêtes GraphQL traite tout côté client, dans votre navigateur. Aucune donnée n'est envoyée ni stockée sur un serveur. Votre contenu reste privé sur votre appareil à tout moment.

Oui, le Constructeur de Requêtes GraphQL est entièrement adaptatif et fonctionne sur smartphones et tablettes. Vous pouvez l'utiliser sur tout appareil doté d'un navigateur web moderne, sans aucune application à télécharger.

Aucun compte ni inscription n'est nécessaire. Ouvrez simplement le Constructeur de Requêtes GraphQL dans votre navigateur et commencez à l'utiliser immédiatement. Il n'y a ni barrière d'inscription ni restriction d'usage.

Le Constructeur de Requêtes GraphQL prend en charge un large éventail de formats et de langages populaires. Consultez l'interface de l'outil pour la liste complète des options prises en charge.

Saisissez simplement votre entrée dans le champ prévu, ajustez les options à votre convenance et l'outil la traitera instantanément. Vous pouvez ensuite copier le résultat dans le presse-papiers ou le télécharger.

Le Constructeur de Requêtes GraphQL fonctionne dans tous les navigateurs modernes, dont Chrome, Firefox, Safari, Edge et Opera. Pour une expérience optimale, utilisez la dernière version de votre navigateur préféré.

Une requête (query) lit des données sans rien modifier — elle demande au serveur des champs précis et les récupère, un peu comme une requête GET. Une mutation écrit des données : elle crée, met à jour ou supprime des enregistrements, et renvoie généralement l'objet concerné pour que vous puissiez confirmer le changement. Les deux utilisent la même syntaxe d'ensemble de sélection pour choisir les champs à renvoyer, mais elles déclarent des mots-clés d'opération différents (query contre mutation), et les mutations prennent presque toujours des arguments en entrée, souvent une variable typée comme un objet input. Il existe aussi un troisième type, subscription, qui maintient une connexion ouverte pour des mises à jour en temps réel. Dans ce générateur, vous choisissez le type d'opération au départ, et il ajuste le mot-clé et la structure générés en conséquence, ce qui permet de passer d'une requête de lecture à une mutation d'écriture sans réécrire l'enveloppe à la main.

Déclarez chaque entrée comme une variable nommée dans la signature de l'opération, donnez-lui un type GraphQL tel que ID!, Int ou String, puis référencez-la dans un argument avec un signe dollar — par exemple user(id: $userId). Envoyer les valeurs séparément sous forme d'objet JSON garde la requête réutilisable, permet à votre client de la mettre en cache, et évite les erreurs de guillemets et d'échappement liées à l'injection de valeurs brutes dans la chaîne. Le point d'exclamation après un type signifie que la variable est obligatoire. Dans ce générateur, déclarer des variables dans la section Variables les insère automatiquement dans la signature, et saisir une valeur commençant par $ dans n'importe quel argument est reconnu comme une référence de variable. Il produit également un objet JSON Variables prêt à coller, à côté de la requête, pour l'utiliser directement dans Postman ou votre client d'API.

Un fragment est un ensemble de champs nommé et réutilisable, défini sur un type précis — par exemple fragment UserFields on User { id name email }. Plutôt que de répéter la même sélection de champs à plusieurs endroits, vous la définissez une seule fois et l'insérez partout où vous avez besoin de ces champs. Les fragments gardent les requêtes volumineuses lisibles, garantissent que deux parties d'une même requête demandent la même forme de données, et facilitent les évolutions de schéma puisque vous modifiez la liste de champs à un seul endroit. Ils sont particulièrement utiles lorsque plusieurs requêtes renvoient le même type d'objet, ou lorsqu'un composant d'interface a toujours besoin des mêmes propriétés. Dans ce générateur, vous ajoutez un fragment, lui donnez un nom et un type cible, puis construisez son arbre de champs de la même manière que la sélection principale — la sortie générée inclut la définition du fragment, prête à l'emploi immédiatement.

GraphQL est conçu pour que le client déclare exactement les champs qu'il souhaite, et le serveur ne renvoie que ceux-là — rien de plus. C'est l'inverse d'un endpoint REST classique, qui envoie une charge utile fixe quel que soit ce que vous utilisez réellement. Demander des champs précis signifie des réponses plus légères, moins de sur-récupération de données que vous jetterez, et aucun aller-retour supplémentaire pour rassembler des enregistrements liés, puisque vous pouvez imbriquer des sous-sélections pour récupérer des objets connectés en une seule requête. La contrepartie est que chaque champ souhaité doit être nommé explicitement dans l'ensemble de sélection, ce qui devient facile à mal faire sans s'en rendre compte à mesure que les requêtes grandissent. Ce générateur rend cette sélection explicite visuelle — vous cliquez pour ajouter et imbriquer des champs à n'importe quelle profondeur, et il écrit l'ensemble de sélection correspondant afin que la structure reflète la forme des données dont vous avez besoin.

La sortie enrichie est formatée sur plusieurs lignes avec une indentation cohérente, ce qui rend les ensembles de sélection imbriqués, les arguments et les fragments faciles à lire et à relire — c'est le format à privilégier lorsque vous versionnez une requête ou que vous la partagez avec des coéquipiers. La sortie minifiée regroupe la même requête sur une seule ligne, sans espaces superflus, ce qui est pratique lorsque vous intégrez la chaîne de requête directement dans du code ou une valeur de configuration où les sauts de ligne sont gênants. Les deux sont fonctionnellement identiques pour le serveur ; seuls les espaces diffèrent, vous pouvez donc passer de l'une à l'autre librement sans changer le comportement. Dans ce générateur, un simple interrupteur bascule instantanément entre les deux vues, et depuis l'une ou l'autre vous pouvez copier la requête, copier le JSON Variables, ou télécharger l'opération sous forme de fichier .graphql.