Data Nodes

Mit Data Nodes können deine Formulare während des Formulardurchlaufs HTTP-API-Aufrufe ausführen. Für Befragte sind sie unsichtbar — sie laufen automatisch ab und können Daten von externen APIs abrufen, Antworten gegen dein Backend validieren oder Aktionen auslösen.

Data Node hinzufügen

1. Öffne dein Formular im Builder.
2. Klicke auf +, um eine neue Frage hinzuzufügen.
3. Wähle Data Node aus der Kategorie „Erweitert".
4. Konfiguriere die HTTP-Anfrage in den Frageeigenschaften.

Konfiguration

HTTP-Methode

Wähle je nach API-Endpunkt zwischen GET, POST, PUT oder DELETE.

URL

Die aufzurufende Endpunkt-URL. Unterstützt Variableninterpolation — verwende {variableName}, um Werte aus Formularvariablen einzusetzen.

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

Hat die befragte Person in einer früheren E-Mail-Frage jane@example.com eingegeben und ist diese als Variable email gespeichert, geht die tatsächliche Anfrage an https://api.example.com/users/jane@example.com.

Header

Anfrage-Header als Schlüssel/Wert-Zeilen. Sowohl Formularvariablen ({variable}) als auch Verbindungs-Secrets ({secret.NAME}) werden unterstützt.

Beispiel:

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

Anfrage-Body

Für POST- und PUT-Anfragen gibst du eine JSON-Body-Vorlage an. Weil der Body JSON ist, verwenden Variablen und Secrets doppelte geschweifte Klammern, damit sie nicht mit den { } von JSON kollidieren — {{variable}} und {{secret.NAME}}.

Beispiel:

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

Data-Node-Secrets

Füge einen API-Schlüssel niemals direkt in eine URL, einen Header oder einen Body ein — speichere Zugangsdaten stattdessen als Data-Node-Secrets und referenziere sie über ihren Namen.

1. Klicke im Data-Node-Editor (oder in den Formulareinstellungen) auf Manage secrets.
2. Klicke auf Add secret, vergib einen Namen (Buchstaben, Zahlen, Unterstriche) und füge den Wert ein.
3. Referenziere es in einem Data Node als {secret.NAME} in der URL oder in Headern, beziehungsweise als {{secret.NAME}} im JSON-Body.

Secrets sind:

• Verschlüsselt gespeichert und werden nur auf unseren Servern aufgelöst, wenn die Anfrage läuft — sie werden niemals an den Browser der befragten Person gesendet.
• Write-only — einmal gespeichert, wird der Wert eines Secrets nie wieder angezeigt. Du kannst den Wert ersetzen oder das Secret löschen, aber nicht einsehen.
• Pro Formular — sie wandern beim Duplizieren mit dem Formular mit, werden aber entfernt, wenn du das Formular als Vorlage veröffentlichst oder verwendest oder es exportierst (die neuen Besitzer hinterlegen ihre eigenen).

Antwortverarbeitung

Antwort speichern

Setze das Feld Response Variable, um die vollständige JSON-Antwort als Formularvariable zu speichern. Diese Daten kannst du dann in späteren Fragen über die {variableName}-Syntax referenzieren.

Beispiel: Wenn du als Antwortvariable user_data festlegst und die API {"name": "Jane", "plan": "pro"} zurückgibt, kannst du in nachfolgenden Fragen {user_data} referenzieren.

Anzeigeoptionen

Ladetext

Passe die Ladeanzeige an, die während der laufenden Anfrage erscheint. Standard: „Loading..."

Stiller Modus

Aktiviere den Silent mode, damit die Anfrage ohne Ladeanzeige im Hintergrund läuft. Das Formular geht weiter, ohne zu warten. Praktisch für Fire-and-forget-Szenarien wie Analytics-Pings oder Webhook-Trigger.

Debug-Modus

Aktiviere den Debug mode, um ein Panel mit allen Details zu Anfrage und Antwort anzuzeigen. Nützlich während der Formularentwicklung — vor dem Veröffentlichen deaktivieren.

Validierungs-Gate

Aktiviere das Validation gate, um den Data Node als Validator für die vorherige Frage zu nutzen. Schlägt die API-Anfrage fehl (keine 2xx-Antwort), kann die befragte Person nicht weitermachen und sieht eine Fehlermeldung.

Anwendungsfall: Einen Gutscheincode validieren, die Verfügbarkeit einer E-Mail-Adresse prüfen oder einen Zugangscode gegen dein Backend verifizieren.

Timeout

Konfiguriere das Anfrage-Timeout in Sekunden (Standard: 10 Sekunden). Dauert die Anfrage länger, schlägt sie fehl und das Formular zeigt einen Fehler (außer im stillen Modus).

Beispiele

Beispiel 1: Gutscheincode validieren

1. Füge eine Kurztext-Frage hinzu, die nach einem Gutscheincode fragt (Antwort als Variable coupon speichern).
2. Füge dahinter einen Data Node hinzu mit:
   • Methode: GET
   • URL: https://api.yoursite.com/coupons/{coupon}
   • Validation gate: aktiviert
   • Antwortvariable: coupon_data
3. Ist der Gutschein ungültig, gibt die API 404 zurück und die befragte Person sieht einen Fehler.
4. Ist er gültig, werden die Rabattinformationen in {coupon_data} gespeichert und stehen später zur Verfügung.

Beispiel 2: Nutzerdaten anreichern

1. Füge eine E-Mail-Frage hinzu (Antwort als Variable email speichern).
2. Füge einen Data Node hinzu:
   • Methode: GET
   • URL: https://api.yoursite.com/users/{email}
   • Silent mode: aktiviert
   • Antwortvariable: user_info
3. Spätere Fragen können {user_info} referenzieren, um Felder vorauszufüllen oder das Erlebnis zu personalisieren.

Beispiel 3: An CRM übermitteln

1. Füge am Ende des Formulars einen Data Node hinzu:
   • Methode: POST
   • URL: https://api.yourcrm.com/leads
   • Body: {"name": "{{name}}", "email": "{{email}}", "phone": "{{phone}}"}
   • Silent mode: aktiviert
2. Der Lead wird direkt im Formulardurchlauf in deinem CRM angelegt — ohne Webhook-Verzögerung.

Verwandte Themen

• Variablen — So funktioniert die Variablenersetzung
• Logiksprünge — Bedingte Verzweigungen auf Basis von Antworten
• Webhooks — Alternative für Integrationen nach der Übermittlung