GraphQL
n8n : GraphQLToutes les offres1 entrée · 1 sortie
Envoie une requête ou une mutation GraphQL à une API, pour chaque élément reçu.
Fonctionnement
Même client protégé que la Requête HTTP : adresses publiques uniquement, vérification après résolution DNS et à chaque redirection, réponse limitée. Une erreur HTTP fait toujours échouer le bloc ; les erreurs GraphQL (champ « errors ») selon le réglage.
Paramètres
| Paramètre | Type | Détail |
|---|---|---|
| Adresse de l'APIobligatoire | adresse | — |
| Méthode | choix | Valeurs : POST (JSON), GET (requête dans l'URL). |
| Authentification | connexion | Facultatif. |
| Requête GraphQLobligatoire | texte long | Passez les valeurs dynamiques par les variables plutôt que dans le texte de la requête. |
| Variables (JSON) | texte long | — |
| Nom de l'opération | texte | Facultatif : utile si la requête en contient plusieurs. |
| En-têtes | clé-valeur | — |
| Erreurs GraphQL dans la réponse | choix | Valeurs : Échouer, Continuer avec { data, errors }. |
| Délai d'expiration (secondes) | nombre | 60 s au plus. |
Données reçues et renvoyées
- EntréeListe d'éléments : une requête par élément.
- SortieUn élément par réponse : { data, errors? }.
Erreurs
Variables qui ne forment pas un objet JSON, réponse non JSON, erreur HTTP, erreurs GraphQL (si « Échouer »).
Exemple
Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.
{
"url": "https://api.github.com/graphql",
"credentialId": "",
"query": "query($login: String!) { user(login: $login) { name followers { totalCount } } }",
"variables": "{ \"login\": \"{{ $json.login }}\" }"
}