GraphQL

Catalogue des nœuds Actions

Sur cette page

Exécuter des requêtes et mutations GraphQL avec des variables.

Utilisation et spécificités

Configurez l’identifiant compatible et la requête ou opération du service. La forme de réponse dépend du service ; inspectez-la avant mapping. Les droits du compte restent applicables aux lectures comme aux écritures.

Type technique : graphql. Runtime : nodulz.

Identifiants et prérequis

GraphQL (integration / graphql). Jeton Bearer pour une API GraphQL. URL configurée dans le nœud.

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`credentialId`	`string`	`""`	-
`endpoint`	`string`	`""`	-
`query`	`string`	`"query { __typename }"`	-
`variables`	`string`	`"{}"`	-
`operationName`	`string`	`""`	-
`failOnErrors`	`boolean`	`true`	-
`timeout`	`number`	`30`	-; ≥ 1, ≤ 600

Aide de configuration

timeout Délai maximal (secondes): Entre 1 et 600 secondes. Une annulation interrompt la requête en cours.
failOnErrors Échouer en cas d’erreurs GraphQL: Échoue aussi si HTTP vaut 200 mais que la réponse contient des erreurs. Désactivez pour traiter les données partielles et errors dans la sortie.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "credentialId": "",
  "endpoint": "",
  "query": "query { __typename }",
  "variables": "{}",
  "operationName": "",
  "failOnErrors": true,
  "timeout": 30
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.