Nœuds de données

Les nœuds de données permettent à vos formulaires d'effectuer des appels API HTTP pendant le flux du formulaire. Ils sont invisibles pour les répondants — ils s'exécutent automatiquement et peuvent récupérer des données depuis des API externes, valider des réponses auprès de votre backend ou déclencher des actions.

Ajouter un nœud de données

1. Ouvrez votre formulaire dans l'éditeur.
2. Cliquez sur + pour ajouter une nouvelle question.
3. Sélectionnez Nœud de données dans la catégorie Avancé.
4. Configurez la requête HTTP dans les propriétés de la question.

Configuration

Méthode HTTP

Choisissez parmi GET, POST, PUT ou DELETE selon votre point de terminaison d'API.

URL

L'URL du point de terminaison à appeler. Prend en charge l'interpolation de variables — utilisez {variableName} pour insérer la valeur d'une variable du formulaire.

Exemple : https://api.example.com/users/{email}

Si le répondant a saisi jane@example.com dans une question e-mail précédente stockée comme variable email, la requête réelle est envoyée à https://api.example.com/users/jane@example.com.

En-têtes

Les en-têtes de la requête sous forme de lignes clé/valeur. Les variables du formulaire ({variable}) et les secrets de connexion ({secret.NAME}) sont tous deux pris en charge.

Exemple :

{
  "Authorization": "Bearer {secret.API_TOKEN}",
  "Content-Type": "application/json"
}

Corps de la requête

Pour les requêtes POST et PUT, fournissez un modèle de corps JSON. Comme le corps est en JSON, les variables et les secrets utilisent des doubles accolades afin de ne pas entrer en conflit avec les { } propres au JSON — {{variable}} et {{secret.NAME}}.

Exemple :

{
  "name": "{{full_name}}",
  "email": "{{email}}",
  "api_key": "{{secret.API_KEY}}",
  "source": "nueform"
}

Secrets de nœud de données

Ne collez jamais une clé d'API directement dans une URL, un en-tête ou un corps — stockez plutôt vos identifiants en tant que secrets de nœud de données et référencez-les par leur nom.

1. Dans l'éditeur de nœud de données (ou dans les Paramètres du formulaire), cliquez sur Gérer les secrets.
2. Cliquez sur Ajouter un secret, donnez-lui un nom (lettres, chiffres, traits de soulignement) et collez la valeur.
3. Référencez-le dans un nœud de données avec {secret.NAME} dans l'URL ou les en-têtes, ou {{secret.NAME}} dans le corps JSON.

Les secrets sont :

• Chiffrés au repos et résolus uniquement sur nos serveurs au moment de l'exécution de la requête — ils ne sont jamais envoyés au navigateur du répondant.
• En écriture seule — une fois enregistrée, la valeur d'un secret n'est plus jamais affichée. Vous pouvez remplacer la valeur ou la supprimer, mais vous ne pouvez pas la consulter.
• Par formulaire — ils accompagnent le formulaire lorsque vous le dupliquez, mais sont retirés lorsque vous publiez ou utilisez un modèle, ou lorsque vous exportez le formulaire (le nouveau propriétaire ajoute les siens).

Gestion de la réponse

Stocker la réponse

Renseignez le champ Variable de réponse pour enregistrer la réponse JSON complète en tant que variable du formulaire. Vous pouvez ensuite référencer ces données dans des questions ultérieures avec la syntaxe {variableName}.

Exemple : si vous définissez la variable de réponse sur user_data et que l'API renvoie {"name": "Jane", "plan": "pro"}, vous pouvez référencer {user_data} dans les questions suivantes.

Options d'affichage

Texte de chargement

Personnalisez le message de chargement affiché pendant l'exécution de la requête. Par défaut : « Loading... »

Mode silencieux

Activez le Mode silencieux pour effectuer la requête en arrière-plan, sans indicateur de chargement. Le formulaire continue sans attendre. Utile pour les scénarios « envoyer et oublier » comme les pings d'analytique ou les déclencheurs de webhooks.

Mode débogage

Activez le Mode débogage pour afficher un panneau contenant tous les détails de la requête et de la réponse. Utile pendant le développement du formulaire — désactivez-le avant la publication.

Validation bloquante

Activez la Validation bloquante pour utiliser le nœud de données comme validateur de la question précédente. Si la requête API échoue (réponse autre que 2xx), le répondant ne peut pas continuer et une erreur s'affiche.

Cas d'usage : valider un code promo, vérifier la disponibilité d'un e-mail ou contrôler un code d'accès auprès de votre backend.

Délai d'expiration

Configurez le délai d'expiration de la requête en secondes (par défaut : 10 secondes). Si la requête prend plus de temps, elle échoue et le formulaire affiche une erreur (sauf en mode silencieux).

Exemples

Exemple 1 : valider un code promo

1. Ajoutez une question Texte court demandant un code promo (réponse stockée dans la variable coupon).
2. Ajoutez un nœud de données juste après, avec :
   • Méthode : GET
   • URL : https://api.yoursite.com/coupons/{coupon}
   • Validation bloquante : activée
   • Variable de réponse : coupon_data
3. Si le code promo est invalide, l'API renvoie une erreur 404 et le répondant voit une erreur.
4. S'il est valide, les informations de remise sont stockées dans {coupon_data} pour une utilisation ultérieure.

Exemple 2 : enrichir les données utilisateur

1. Ajoutez une question E-mail (réponse stockée dans la variable email).
2. Ajoutez un nœud de données :
   • Méthode : GET
   • URL : https://api.yoursite.com/users/{email}
   • Mode silencieux : activé
   • Variable de réponse : user_info
3. Les questions suivantes peuvent référencer {user_info} pour préremplir des champs ou personnaliser l'expérience.

Exemple 3 : envoyer vers un CRM

1. À la fin du formulaire, ajoutez un nœud de données :
   • Méthode : POST
   • URL : https://api.yourcrm.com/leads
   • Corps : {"name": "{{name}}", "email": "{{email}}", "phone": "{{phone}}"}
   • Mode silencieux : activé
2. Le prospect est créé dans votre CRM dans le cadre du flux du formulaire — sans délai de webhook.

Voir aussi

• Variables — Fonctionnement de la substitution de variables
• Sauts logiques — Branchement conditionnel selon les réponses
• Webhooks — Alternative pour les intégrations après soumission