GraphQL
Clic droit dans l’arbre ▸ Ajouter ▸ Requête GraphQL.
Configuration
Section titled “Configuration”| Champ | Rôle |
|---|---|
| URL | Le point d’entrée GraphQL |
| Type d’opération | query, mutation ou subscription |
| Requête | Le document GraphQL, avec coloration syntaxique |
| Variables | Les variables de l’opération, en JSON |
| Nom d’opération | Obligatoire dès que le document contient plusieurs opérations nommées |
| En-têtes | Comme pour une requête HTTP |
Les {{variables}} Restorm fonctionnent dans le document comme dans les
variables GraphQL — attention à ne pas confondre les deux systèmes : $id est
une variable GraphQL, {{id}} une variable Restorm.
Abonnements
Section titled “Abonnements”Un subscription ouvre un flux : les messages arrivent au fil de l’eau dans le
panneau de réponse. Dans un scénario, les
actions S’abonner GraphQL / Se désabonner GraphQL pilotent le même flux et
émettent un événement par message reçu.
Importer un schéma
Section titled “Importer un schéma”Un fichier .graphql / .gql (SDL) crée une arborescence complète : un dossier
par type d’opération, une requête par champ racine, avec des variables
d’argument pré-remplies, la documentation d’API et les énumérations. Voir
Importer un schéma GraphQL.
Les collections Postman, Bruno, Insomnia et Thunder Client dont les requêtes sont de type GraphQL sont importées en requêtes GraphQL, pas en requêtes HTTP.
Mode serveur
Section titled “Mode serveur”Restorm sait héberger un serveur GraphQL de simulation : vous fournissez le
schéma (SDL) et, au choix, des valeurs canned par champ (Query.pets) ou un
script de résolution en JavaScript qui l’emporte sur elles. Les abonnements
sont servis eux aussi. Voir
Simuler une API GraphQL.
Extraits de code
Section titled “Extraits de code”Treize cibles : cURL, JavaScript (Fetch, Apollo Client), TypeScript, Python (Requests, gql), Go (graphql-go), Ruby (graphql-client), PHP (Guzzle), C# (GraphQL.Client), Java (graphql-java), Swift (Apollo iOS), Kotlin (Apollo Kotlin).