Comment utiliser : Générateur de requête GraphQL
- Ouvrez Schéma (SDL) et collez votre schéma, ou utilisez l'exemple fourni.
- Choisissez Query, Mutation ou Subscription.
- Cochez les champs dans l'arborescence ; développez les objets pour choisir les champs imbriqués et renseigner les arguments.
- Copiez la requête générée, le JSON des variables ou l'appel
fetch()prêt à l'emploi.
Fonctionnement du générateur
Le schéma est analysé avec graphql-js et transformé en arborescence partant du type racine de l'opération choisie. Cocher un champ l'ajoute à la sélection ; cocher un champ objet le développe pour choisir ses sous-champs. Les arguments renseignés deviennent des variables avec les types GraphQL appropriés ($id: ID!), ce qui rend la requête réutilisable et protégée contre les injections, et le JSON des variables est généré à côté.
Astuces
- Les champs typés comme des interfaces ou des unions affichent leurs implémentations sous forme de fragments en ligne (
... on Book). - Les arguments obligatoires sont marqués d'un
!; laissez les arguments facultatifs vides pour les omettre. - Utilisez le champ de filtre pour trouver un champ dans les schémas volumineux.
Formatez ou vérifiez une requête existante avec le formateur et validateur GraphQL, et inspectez la réponse JSON dans la visionneuse JSON.
Aussi recherché comme : graphql query builder, créer requête graphql, explorateur graphql, générateur de mutation graphql, alternative graphql playground, construire requête graphql en ligne.
Outils complémentaires : Générateur de requête GraphQL
- cURL vers code — Collez une commande curl, issue de la documentation d’une API ou de l’option « Copier en tant que cURL » des outils de développement de votre navigateur, et obtenez du code prêt à l’emploi pour six langages, avec les en-têtes, le corps de requête et l’authentification repris à l’identique.
- Validateur OpenAPI / Swagger — Collez une spécification d'API pour la vérifier par rapport au schéma OpenAPI officiel, repérer les références cassées et les paramètres de chemin incohérents, et voir tous vos endpoints d'un coup d'œil.
- JSON vers les types — Collez une réponse API et obtenez des modèles prêts à l'emploi dans 8 langages : TypeScript, Python (dataclass, TypedDict ou Pydantic), Go, Java, C#, Kotlin, Swift et Rust.
- Validateur JSON Schema — Collez un schéma et du JSON pour voir précisément quelles valeurs enfreignent quelle règle, ou générez un schéma de départ à partir de données d'exemple.
Questions fréquentes
Où trouver mon schéma SDL ?
De nombreux serveurs l'exposent à l'adresse
/graphql/schema ou dans le dépôt du projet (schema.graphql). Vous pouvez aussi l'exporter avec rover graph introspect ou npx get-graphql-schema https://api.example.com/graphql.L'outil envoie-t-il la requête à mon API ?
Non. Le générateur produit uniquement du texte dans votre navigateur. Copiez l'extrait fetch pour l'exécuter vous-même.
Les fragments sont-ils pris en charge ?
Les champs d'interface et d'union génèrent des fragments en ligne pour chaque type possible. Vous pouvez ajouter des fragments nommés à la main et les vérifier avec le formateur GraphQL.
Puis-je installer Générateur de requête GraphQL en tant qu’application web et l’utiliser hors ligne ?
Oui. Générateur de requête GraphQL est une application web installable (PWA) : elle s’installe depuis votre navigateur, sans passer par une boutique d’applications. Cliquez sur « Installer l’application » en haut de cette page dans Chrome ou Edge (Windows, macOS, Linux, ChromeOS) ; sur Android, utilisez « Partager » → « Ajouter à l’écran d’accueil » sur iPhone et iPad ; ou « Fichier » → « Ajouter au Dock » dans Safari 17+ sur Mac. L’application s’ouvre alors dans sa propre fenêtre avec sa propre icône, et comme elle s’exécute entièrement dans votre navigateur, elle continue de fonctionner hors ligne. Firefox sur ordinateur de bureau ne permet pas d’installer d’applications web. Comment fonctionne l’installation.