Daten an ein anderes System senden

Der Schritt HTTP-Anfrage senden ruft eine URL auf, wenn ein Workflow ihn erreicht. Nutzen Sie ihn, um Buchungsdetails an Ihre eigenen Tools, einen Tabellendienst oder jedes System zu übergeben, das Webanfragen annimmt. Dieser Schritt erfordert den Ultimate-Tarif.

1. 1

   Schritt 1 von 5

   Den Schritt hinzufügen

   Klicken Sie im Editor auf Nächsten Schritt hinzufügen und wählen Sie HTTP-Anfrage senden. Klicken Sie auf den neuen Schritt, um seine Einstellungen zu öffnen.

2. 2

   Schritt 2 von 5

   Methode und URL festlegen

   Wählen Sie eine Methode: GET, POST, PUT, PATCH oder DELETE. Geben Sie die URL ein, beginnend mit https:// oder http://. Die URL kann Variablen enthalten, zum Beispiel https://example.com/clients/{{ $event.data.object.client.id }}.

3. 3

   Schritt 3 von 5

   Einen Body hinzufügen

   Setzen Sie bei POST, PUT, PATCH und DELETE den Inhaltstyp auf application/json und schreiben Sie den Body als JSON. Klicken Sie auf Variable einfügen, um Werte hinzuzufügen.

   Wenn eine Variable der gesamte Wert eines JSON-Felds ist, behält sie ihren Typ. In {"appointment": "{{ $event.data.object }}"} wird der Termin zum Beispiel als Objekt gesendet, nicht als Text. Formatierung und Leerzeichen spielen keine Rolle.

4. 4

   Schritt 4 von 5

   Bei Bedarf Header hinzufügen

   Klicken Sie auf Erweiterte Optionen anzeigen und dann für jeden Header auf Header hinzufügen, etwa für einen Autorisierungsschlüssel. Geben Sie einen Header-Name und einen Header-Wert ein.

5. 5

   Schritt 5 von 5

   Speichern

   Klicken Sie im Dialog auf Speichern und dann oben im Editor auf Speichern.

   Das sehen Sie:

   Der Schritt zeigt die Methode und die URL, zum Beispiel HTTP POST-Anfrage senden an Ihre URL.

Die Antwort verwenden

Die nächsten Schritte können die Antwort über $previousNode lesen:

• {{ $previousNode.response.status }}: der Statuscode, etwa 200
• {{ $previousNode.response.statusText }}: der Statustext, etwa OK
• {{ $previousNode.response.body }}: der Body der Antwort
• {{ $previousNode.response.headers }}: die Header der Antwort

Fügen Sie zum Beispiel eine Bedingte Verzweigung hinzu, die {{ $previousNode.response.status === 200 }} prüft.

Grenzen

Anfragen über einer Grenze werden nicht gesendet. Der Schritt wird übersprungen, und die Ausführung läuft weiter.

Anfragen an private oder interne Netzwerkadressen wie localhost werden blockiert.

Wenn eine Ausführung fehlschlägt

Ein Fehlerstatus des anderen Systems, etwa 404 oder 500, lässt die Ausführung nicht fehlschlagen. Die Antwort wird gespeichert, und der nächste Schritt läuft. Prüfen Sie den Status mit einer Bedingte Verzweigung, wenn er wichtig ist.

Die Ausführung schlägt fehl und stoppt, wenn die Anfrage gar nicht gesendet werden kann: Das System antwortet nicht innerhalb von 5 Sekunden, die Adresse ist nicht erreichbar, die URL ist ungültig oder sie zeigt auf eine blockierte Adresse. Die Ausführung erscheint im Verlauf als Fehlgeschlagen.