REST-Anfrage-Schritt

Beschreibung

Der Schritt REST-Anfrage ruft eine REST-API als einen Schritt in einem Workflow auf. Er ist ein einziger Schritt im Postman-Stil für den gesamten Kreislauf „erstellen → senden → prüfen“: Wählen Sie einen Endpunkt (von Hand eingegeben oder aus einer Postman-Collection, einer OpenAPI-/Swagger-Spezifikation oder einer HAR-Aufzeichnung importiert), legen Sie Header, Abfrageparameter und einen Body fest, senden Sie eine Testanfrage, um die Live-Antwort zu sehen, und speichern Sie dann den Schritt.

Sie bestimmen, wohin die Antwort geht. Standardmäßig wird sie in eine Tabelle geparst. Alternativ kann der Schritt die Antwort in Workflow-Variablen übernehmen, sodass ein späterer Schritt anhand des Statuscodes verzweigen oder einen Wert aus dem Body lesen kann.

Wenn Sie den Browser vor dem Speichern schließen oder neu laden, behält der Editor in diesem Browser einen lokalen Entwurf. Öffnen Sie denselben Schritt erneut und wählen Sie auf die Aufforderung hin Wiederherstellen, um die nicht gespeicherten Anfrageeinstellungen zurückzuholen.

Bevor Sie beginnen

In der Regel benötigen Sie eine Verbindung vom Typ REST, die die Basis-URL und die Authentifizierung für den Dienst enthält. Der Schritt kann auch ohne Verbindung direkt eine vollständig qualifizierte URL aufrufen. Siehe REST-Verbindungen.

Einen REST-Anfrage-Schritt hinzufügen

Öffnen Sie den Workflow und fügen Sie an der gewünschten Stelle einen Schritt hinzu.
Wählen Sie REST-Anfrage (vereinheitlicht) als Schritttyp (unter den REST-Schritten). Der Editor öffnet sich mit den Registerkarten Anfrage, Antwort und Tabellendatenauswahl.

Die Anfrage erstellen

Auf der Registerkarte Anfrage:

Endpunktquelle

Wählen Sie, wie Sie den Endpunkt angeben, und PlaidCloud füllt die Anfrage für Sie aus:

Manuell – geben Sie Methode und URL selbst ein.
Aus der API-Definition der Verbindung – verwenden Sie die OpenAPI-/Swagger-Definition, die in der ausgewählten Verbindung gespeichert ist, damit Sie sie nicht in jedem Schritt wiederholen müssen. Siehe Die API-Definition einer Verbindung wiederverwenden weiter unten.
Postman-Collection (Datei) / Postman-Collection (URL) – aus einer Postman-Collection importieren.
OpenAPI / Swagger (URL) / OpenAPI / Swagger (Datei) – aus einer API-Spezifikation importieren.
HAR-Archiv (Datei) – eine aus dem Netzwerkprotokoll Ihres Browsers aufgezeichnete Anfrage importieren.

Wählen Sie bei einer importierten Quelle Katalog laden, um die verfügbaren Endpunkte aufzulisten, und wählen Sie dann unter Endpunkt einen aus. Der Schritt füllt Methode, URL, Header, Abfrageparameter und Body aus, wobei er den Beispiel- oder Standardwert jedes Parameters verwendet; ein optionaler Parameter, der keines von beidem hat, beginnt ausgeschaltet. Enthält die Anfrage bereits etwas, das Sie eingegeben haben, fragt der Schritt vor dem Ersetzen nach. Drücken Sie Strg+Z (Cmd+Z auf dem Mac), wenn Sie nicht in einem Feld tippen, oder wählen Sie Ersetzen rückgängig machen, um die vorherige Anfrage zurückzuholen.

Einen großen Katalog können Sie leicht eingrenzen: Geben Sie in Nach Methode, Pfad oder Name filtern… einen Text ein, um nur die passenden Endpunkte aufzulisten. Der Katalog zeigt, wie viele Endpunkte er enthält (12 von 340 bei aktivem Filter) und wann er geladen wurde, und der Schritt weist darauf hin, wenn eine sehr große Definition am Vorschaulimit abgeschnitten wurde.

Eine Collection oder Spezifikation einfügen, statt eine Datei auszuwählen

Die drei dateibasierten Quellen – Postman-Collection, OpenAPI/Swagger und HAR-Archiv – bieten jeweils neben der Dateiauswahl eine Schaltfläche Einfügen…. Verwenden Sie sie, wenn Sie den Inhalt zur Hand haben, ihn aber nicht in Document gespeichert haben: Fügen Sie das JSON ein und wählen Sie Dies verwenden. Der Katalog wird sofort geladen, sodass Sie anschließend nicht Katalog laden anklicken müssen.

Eingefügter Inhalt wird anstelle der Dateiauswahl verwendet und bleibt so lange erhalten, wie der Schritt geöffnet bleibt – er wird nicht mit dem Schritt gespeichert. Fügen Sie ihn daher erneut ein, wenn Sie den Schritt wieder öffnen und den Katalog daraus neu laden möchten. Wählen Sie für dieselbe Quelle eine Datei aus, hat die Datei Vorrang und der eingefügte Inhalt wird verworfen – der Schritt teilt Ihnen mit, wenn das geschieht.

Sie können auch eine .json-Datei auf die Quellauswahl ziehen. Der Schritt prüft den Inhalt anhand der gewählten Quelle und teilt Ihnen mit, was nicht stimmt, etwa eine Postman-Collection, die dort eingefügt wurde, wo eine OpenAPI-Spezifikation erwartet wird, oder eine Datei, die kein JSON ist; jede Quelle hat außerdem einen Link Wie erhalte ich …?, der erklärt, wie Sie eine Postman-Collection, eine OpenAPI-Spezifikation oder eine HAR-Datei exportieren.

Die API-Definition einer Verbindung wiederverwenden

Für einen bestimmten Dienst entwickelte Konnektoren kennen ihre Endpunkte bereits. Generische REST- und MuleSoft-Verbindungen nicht – sie können auf jede beliebige API zeigen –, deshalb können Sie die Definition der API an die Verbindung selbst anhängen.

Legen Sie sie einmal an der Verbindung fest (siehe Generische REST-Verbindung) und gehen Sie dann in jedem Schritt, der diese Verbindung verwendet, so vor:

Wählen Sie die Verbindung unter Verbindung.
Stellen Sie Endpunktquelle auf Aus der API-Definition der Verbindung.
Wählen Sie Katalog laden und wählen Sie Ihren Endpunkt.

Jeder Schritt, der diese Verbindung gemeinsam nutzt, bietet dieselbe Endpunktliste, und die Aktualisierung der Definition an der Verbindung aktualisiert alle.

Verbindungszusammenfassung und Umgebung

Unter der Auswahl Verbindung zeigt eine Zusammenfassungszeile, was der Schritt verwenden wird: den Authentifizierungstyp, den Host und wie viele Standard-Header die Verbindung bei jeder Anfrage sendet. Wählen Sie die Schaltfläche „Aktualisieren“ neben der Auswahl, nachdem Sie die Verbindung geändert haben, um Authentifizierung, Host und Standard-Header neu zu laden, ohne den Schritt erneut zu öffnen. Definiert die Verbindung Umgebungen, legt die Auswahl Umgebung fest, gegen welche der Schritt ausgeführt wird.

Verbindung, Methode und Endpunkt

Verbindung – die REST-Verbindung, mit der authentifiziert wird. Lassen Sie sie leer, um direkt eine vollständig qualifizierte URL aufzurufen. Verwenden Sie die Bearbeitungsverknüpfung neben der Auswahl, um die gewählte Verbindung anzusehen oder zu bearbeiten, ohne den Anfrageeditor zu verlassen.
Methode – GET, POST, PUT, PATCH, DELETE, HEAD oder OPTIONS.
Endpunkt – der Pfad (wenn eine Verbindung gesetzt ist) oder eine vollständige URL.

Header, Abfrageparameter und Body

Header und Abfrageparameter sind bearbeitbare Tabellen mit Name/Wert-Zeilen, jeweils mit einem Schalter Bei und einer Beschreibung. Fügen Sie Zeilen mit Hinzufügen hinzu und entfernen Sie sie mit Entfernen.
Body enthält die Nutzlast der Anfrage (JSON, Formular oder Rohdaten) in einem Code-Editor.

JSON formatieren rückt den Body ein, und JSON validieren prüft ihn und meldet Zeile und Spalte jedes Fehlers. Beide lesen jede Variable {{…}} als Wert, sodass Ihre Variablen genau so bleiben, wie geschrieben. Variablenreferenz… listet jede Variable auf, die Sie in der Anfrage verwenden können, und Einfügen {{…}} setzt eine Variable an der Cursorposition ein.

Während Sie bearbeiten, markiert der Schritt Probleme unter der Anfrage:

Ein Header- oder Abfrageparametername, der doppelt vorkommt, sodass ein Wert verloren ginge.
Ein Headername, der falsch geschrieben aussieht, mit einem Vorschlag Meinten Sie…, etwa Authorisation statt Authorization.
Ein Geheimnis, etwa ein Wert für Authorization oder X-API-Key, das im Klartext eingegeben wurde. Bewahren Sie es in einer Projektvariable auf und schreiben Sie {{project_var.NAME}}, damit das Geheimnis nicht im Schritt gespeichert wird.
Ein JSON-Body ohne Header Content-Type: application/json, was manche Server mit HTTP 415 ablehnen.
Eine URL mit falsch geschriebenem Schema, doppeltem Schrägstrich im Pfad, nachgestelltem Schrägstrich oder überzähligen Leerzeichen.

Variablenersetzung

Überall im Endpunkt, in den Headern, Abfragewerten oder im Body können Sie zur Laufzeit eine Variable einsetzen, indem Sie ihren Namen in doppelte geschweifte Klammern setzen: {{name}}. Sie können auch {{var.name}} für eine Variable der Workflow-Ausführung oder {{project_var.name}} für eine Projektvariable schreiben – das Präfix ist optional, und beide lösen denselben Namen auf.

Der Editor hebt erkannte Token {{...}} im Endpunkt, in den Tabellen für Header und Abfrageparameter sowie im Body-Editor hervor, sodass Ersetzungen vor dem Testen oder Speichern leicht zu erkennen sind.

Nur doppelte geschweifte Klammern werden ersetzt, sodass ein einzelnes { oder } in einem JSON-Body genau so bleibt, wie geschrieben – Sie können Variablen frei in JSON mischen, zum Beispiel {"id": "{{var.order_id}}", "qty": 1}. Ein unbekannter Variablenname lässt den Schritt fehlschlagen, damit ein Tippfehler sofort auffällt.

Wird der Workflow durch einen Sensor oder Webhook gestartet, stehen außerdem vier Trigger-Variablen zur Verfügung: {{trigger_sensor_id}}, {{trigger_sensor_type}}, {{trigger_fired_at}} und {{trigger_payload_json}} (die eingehende Nutzlast als JSON-Zeichenfolge – parsen Sie sie in einem späteren Schritt, um verschachtelte Felder zu erreichen). Bei einer manuellen oder per Zeitplan gestarteten Ausführung werden sie zu einer leeren Zeichenfolge aufgelöst.

Die Anfrage testen

Testanfrage senden sendet die Anfrage mit Ihren aktuellen Einstellungen und zeigt die Live-Antwort inline an, sodass Sie vor dem Speichern bestätigen können, dass der Aufruf funktioniert. Drücken Sie Strg+Eingabe (Cmd+Eingabe auf dem Mac), um von überall im Formular zu senden. Eine Statuszeile zeigt den HTTP-Status und die Antwortzeit, und ein Timer zählt hoch, während die Anfrage unterwegs ist. (Dies sendet eine einzelne Anfrage; die Paginierung läuft nur, wenn der Schritt ausgeführt wird.)
Paginierung testen folgt der konfigurierten Paginierung und meldet, wie viele Datensätze über die Seiten hinweg zurückkommen (bis zu einem Vorschaulimit), sodass Sie bestätigen können, dass der Paginierungsmodus und seine Parameter/Pfade vor einer vollständigen Ausführung korrekt verkettet sind. Es werden nur so viele Seiten abgerufen, wie nötig sind, um das Limit zu erreichen.
Als curl kopieren kopiert einen entsprechenden curl-Befehl zum Teilen oder Debuggen in die Zwischenablage (mit maskierten Geheimnissen).
Aus curl importieren macht das Gegenteil: Fügen Sie einen curl-Befehl ein – zum Beispiel „Copy as cURL“ aus einem Browser –, und seine Methode, URL, Header und sein Body ersetzen die aktuelle Anfrage. Basic-Authentifizierung (-u) wird zu einem Authorization-Header; nicht unterstützte Optionen werden gemeldet, statt stillschweigend verworfen zu werden. Verwenden Sie Ersetzen rückgängig machen, um die vorherigen Werte wiederherzustellen.

Die Antwort öffnet sich in einem Viewer mit den Ansichten Formatiert und Kompakt. Die letzten fünf Testergebnisse bleiben erhalten, solange der Schritt geöffnet ist, und Sie können eines auswählen, um es erneut anzusehen oder erneut auszuführen. Enthält die Antwort eine Liste von Datensätzen, setzt Vorschlagen den Elementpfad auf die erste gefundene Liste.

Die Gruppe Anfragevorschau zeigt die Anfrage genau so, wie eine Ausführung sie senden würde, mit aufgelösten Variablen und maskierten Geheimnissen, ohne etwas zu senden. Wählen Sie Vorschau aktualisieren, nachdem Sie bearbeitet haben.

Ändern Sie die Felder der ausgehenden Anfrage und speichern Sie vor einer erfolgreichen Testanfrage senden, fragt PlaidCloud Ohne erfolgreichen Test speichern?, und Sie wählen Trotzdem speichern oder gehen zurück. Verwenden Sie im Fan-out-Modus Zeile 1 testen, um die erste Treiberzeile vor dem Speichern zu testen.

Die Antwort weiterleiten

Legen Sie auf der Registerkarte Antwort das Antwortziel fest:

Tabelle (Standard)

Die Antwort wird in die Zieltabelle geparst, die in diesem Modus erforderlich ist. Wählen Sie eine vorhandene Tabelle oder erstellen Sie über die Auswahl eine; Ansichten werden nicht angeboten. Die Gruppe Paginierung und Analyse steuert, wie:

Zeilenformat – Objekt (Standard), wenn jeder Datensatz ein JSON-Objekt ist, oder Array, wenn jeder Datensatz eine Liste von Werten ist. Array ist mit Eine Anfrage pro Tabellenzeile nicht verfügbar. Elementpfad gibt an, wo die Datensätze in der Antwort liegen.

Paginierungsmodus – Keine Seitenumbrechung (Standard), Offset-Paginierung, Paginierung nach Seitennummer, Paginierung über nächste Seiten-URL, Cursor-Paginierung oder Paginierung über Link-Header (RFC 5988). Modusparameter und Modus-Pfade geben an, welche Parameter und Antwortfelder die Paginierung steuern, und sie sind nur verfügbar, wenn ein Paginierungsmodus gewählt ist. Die Wahl eines Modus füllt beide mit seinen Standardwerten, die Sie bearbeiten können.

Modus	Standard für Modusparameter	Standard für Modus-Pfade	Wie die Seiten abgerufen werden
Offset	`{"offset": "offset", "limit": "limit"}`	`{"has_more": ["has_more"]}`	Sendet die Abfrageparameter für Offset und Limit und liest weiter, solange `has_more` der Antwort wahr ist.
Seitennummer	`{"offset": "page"}`	`{"has_more": ["has_more"]}`	Sendet die Seitennummer im Parameter `page` und sendet kein Limit.
Nächste Seiten-URL	`{}`	`{"next": ["next"]}`	Fordert die URL an, die sich im Pfad `next` jeder Antwort findet. Eine relative URL wird gegen die Seite gelesen, von der sie stammt.
Cursor	`{"cursor": "after"}`	`{"has_more": ["has_more"], "cursor": ["next_cursor"]}`	Sendet den Cursor aus der vorherigen Antwort im Parameter `after`. Fügen Sie `"send_as": "header"` oder `"send_as": "body_field"` zu Modusparameter hinzu, um ihn stattdessen als Anfrage-Header oder Body-Feld zu senden. Um den Cursor aus einem Antwort-Header zu lesen, etwa dem Header `x-ms-continuation`, den Azure Cosmos DB sendet, tragen Sie `"token_header": "x-ms-continuation"` in Modus-Pfade anstelle von `has_more` und `cursor` ein; die letzte Seite ist die ohne den Header.
Link-Header	`{"rel": "next"}`	`{}`	Folgt der durch `rel` benannten Relation des Antwort-Headers `Link`.

Offset und Seitennummer akzeptieren in Modusparameter weitere Schlüssel: start ist der erste Offset oder die erste Seitennummer (Standard 0), stop_on_empty hält bei der ersten Seite ohne Datensätze am Elementpfad an, sodass die Antwort kein Feld has_more benötigt, und send_limit gibt an, ob der Parameter limit gesendet wird (Standard wahr für Offset, falsch für Seitennummer).

Rohes JSON ausgeben, statt Zeilen zu analysieren – speichert die rohe Nutzlast, statt sie in Spalten zu parsen.
Wiederholungen (0 bis 100) und Timeout (s) (1 bis 600) – wie sich die Anfrage bei Fehlern verhält und wie lange sie laufen darf. Eine Ausführung wartet bis zu dem von Ihnen festgelegten Timeout; Testanfrage senden, Zeile 1 testen und Paginierung testen warten höchstens 300 s. Wiederholungen decken Verbindungsfehler, Serverfehler (5xx) und Ratenbegrenzung (HTTP 429) bei idempotenten Methoden (GET, HEAD, OPTIONS, DELETE) ab. Ein POST, PUT oder PATCH wird nur nach einer Antwort mit Ratenbegrenzung (HTTP 429) wiederholt, die Ihnen sagt, dass der Server damit nichts getan hat, und nie nach einem Serverfehler, sodass ein nicht idempotenter Anfrage-Body nie zweimal gesendet wird, nachdem der Server möglicherweise bereits gehandelt hat; liefert die API einen Header Retry-After, wartet der Schritt das angeforderte Intervall (auf 2 Minuten begrenzt), bevor er wiederholt.

Die Registerkarte Tabellendatenauswahl ordnet die Felder der Antwort den Spalten der Zieltabelle zu. Quelle untersuchen → Befüllen füllt die Zuordnung aus einer Live-Antwort: Es sendet die Anfrage des Schritts über seine Verbindung, wie es eine Ausführung täte. Es benötigt eine Verbindung und fragt vorher nach, wenn die Methode etwas anderes als GET, HEAD oder OPTIONS ist. Zusammenfassen und Eindeutig werden hier nicht angeboten, weil der Schritt die geparste Antwort direkt in die Zieltabelle schreibt.

Workflow-Variablen

Stellen Sie Ziel auf Workflow-Variablen und geben Sie ein Variablenpräfix an (ein einfacher Name wie my_call). Der Schritt sendet eine Anfrage und schreibt vier Workflow-Variablen:

Variable	Inhalt
`{prefix}_status`	HTTP-Statuscode (zum Beispiel `200`).
`{prefix}_body`	Antworttext als Zeichenfolge (JSON-Antworten werden als JSON-Text gespeichert).
`{prefix}_headers`	Antwort-Header als JSON-Text.
`{prefix}_elapsed_ms`	Wie lange die Anfrage gedauert hat, in Millisekunden.

Verweisen Sie nachgelagert darauf wie auf jede Workflow-Variable – zum Beispiel {my_call_status}. Dies ist der Baustein für Muster wie „eine Anfrage senden, dann anhand des Ergebnisses verzweigen“.

Eine Anfrage pro Tabellenzeile senden

Standardmäßig sendet der Schritt eine Anfrage. Um eine API einmal pro Zeile einer Tabelle aufzurufen – zum Beispiel jede Kunden-ID in einer Tabelle nachzuschlagen oder jede Zeile als Datensatz per POST zu senden –, stellen Sie Senden (auf der Registerkarte „Anfrage“) auf Eine Anfrage pro Tabellenzeile. Dadurch werden die Felder der Treibertabelle eingeblendet:

Treibertabelle – wählen Sie die Tabelle, deren Zeilen die Anfragen steuern. Wählen Sie sie mit der Auswahl aus den Tabellen des Workflows oder geben Sie einen Tabellennamen ein. Die Spalten jeder Zeile stehen als Token {{row.column}} zur Verfügung.
Treiberfilter (optional) – eine SQL-WHERE-Klausel, die einschränkt, welche Zeilen verwendet werden.
Schlüsselspalten (optional) – durch Kommas getrennte Treiberspalten, die in jede Ausgabezeile übernommen werden, sodass sich die Ergebnisse wieder mit dem Treiber verknüpfen lassen.
Zeilenlimit und Parallelität – die maximale Anzahl zu verarbeitender Zeilen und wie viele Anfragen gleichzeitig laufen.
Max. Anfr./Sek. (optional) – begrenzt, wie schnell Anfragen über alle Worker hinweg starten, damit ein Ansturm das Ratenlimit der API nicht auslöst (0 = kein Limit). Der Wert kann ein Bruch sein: 0.5 startet alle zwei Sekunden eine Anfrage. Ein Wert über 1000 läuft als 1000, mit einer Warnung. Dies ist unabhängig von Parallelität: Die Parallelität begrenzt, wie viele gleichzeitig laufen, während Max. Anfr./Sek. festlegt, wie oft eine neue startet.
Header Idempotency-Key hinzufügen (optional) – sendet bei einer einzelnen POST-, PUT- oder PATCH-Anfrage pro Zeile (ohne Paginierung) einen stabilen Header Idempotency-Key, der aus jeder Zeile abgeleitet wird, sodass eine erneute Ausführung des Schritts bei einer Idempotenz unterstützenden API keine Datensätze doppelt anlegt (dieselbe Zeile sendet immer denselben Schlüssel, sodass die API die Wiederholung dedupliziert). Bei GET/HEAD/DELETE oder wenn ein Paginierungsmodus aktiv ist, wird er mit einer Warnung ignoriert. Eine Anfrage, die bereits einen eigenen Idempotency-Key setzt, behält ihn.
Antwort – wie jede Antwort zu Zeilen wird. Geparste Datensätze (Standard) schreibt jeden Datensatz der Antwort als Zeile. Text (eine Zeile pro Anfrage) schreibt eine Zeile pro Anfrage mit den Spalten DownloadData und DownloadHeaders; eine fehlgeschlagene Anfrage wird verworfen. Rohtext, Fehler als Zeilen schreibt ebenfalls eine Zeile pro Anfrage, behält aber den Body exakt so, wie der Server ihn gesendet hat, fügt eine Spalte DownloadStatus hinzu und behält einen HTTP- oder Transportfehler als Zeile mit seinem Fehler-Body und Status. Zugangsdaten werden im Body, in den Headern und im Fehlertext jeder Rohzeile maskiert, und einer Weiterleitung zu einem anderen Ursprung wird bei einer Anfrage mit Zugangsdaten nicht gefolgt. Die Paginierung gilt nicht für die Textmodi. In Text (eine Zeile pro Anfrage) schreibt Fehlerantwort beibehalten (keep_error_response) den Body einer Antwort ab HTTP 400 genauso wie bei einem Erfolg in die Zeile, statt die Zeile fehlschlagen zu lassen, und DownloadStatus, DownloadReason und DownloadUrl zur Ausgabe hinzufügen (response_meta) fügt die Spalten DownloadStatus, DownloadReason und DownloadUrl mit Status, Grund und finaler URL der Antwort hinzu. Beide sind standardmäßig ausgeschaltet. Das Schrittformular bietet die Option DownloadStatus, DownloadReason und DownloadUrl zur Ausgabe hinzufügen; setzen Sie keep_error_response mit einem KI-Assistenten oder über die REST-API.
Bei Fehler fortfahren – wenn aktiviert, wird eine fehlgeschlagene Zeile festgehalten, und der Schritt endet mit einer Warnung, statt beim ersten Fehler abzubrechen. Das Ausführungsprotokoll nennt die ersten fehlgeschlagenen Zeilen (anhand ihrer Schlüsselspalten) und den jeweils aufgetretenen Fehler, sodass Sie erkennen können, welche Zeilen warum fehlgeschlagen sind.

Verwenden Sie Token {{row.column}} überall im Endpunkt, in der Abfrage, in den Headern oder im Body, um die Werte dieser Zeile einzusetzen – zum Beispiel GET /customers/{{row.customer_id}}. Ein Wert in einem Abfrageparameter wird einmal URL-codiert, sodass der Server A 1 und a/b so erhält, wie eingegeben. Frühere Versionen codierten ihn zweimal, und der Server erhielt A%201 und a%2Fb. Ist bei einem POST-, PUT- oder PATCH-Schritt Header Idempotency-Key hinzufügen aktiviert und enthält die Abfrage einen Zeilenwert, der codiert werden muss, ändert sich sein Schlüssel nach dem Upgrade einmalig, weil sich die Anfrage geändert hat. Eine erneute Ausführung, die das Upgrade überspannt, kann für jede solche Zeile eine wiederholte Anfrage senden. Werte, die nur aus Buchstaben, Ziffern und -._~ bestehen, bleiben unverändert. Die Antwortdatensätze jeder Zeile werden in die Zieltabelle geparst (mit vorangestellten Schlüsselspalten); ist Rohes JSON ausgeben aktiviert, erhalten Sie stattdessen eine Zeile pro Anfrage.

Das Menü Einfügen {{row.column}} listet die Spalten der ausgewählten Treibertabelle auf, sodass Sie ein Token im Stil von {{row.customer_id}} in den Endpunkt oder den Body – je nachdem, welches Feld Sie zuletzt bearbeitet haben – einfügen können, statt Spaltennamen von Hand zu tippen. Während Sie bearbeiten, listet das Formular außerdem die von Ihnen verwendeten Token {{row.column}} auf und hebt rot hervor, welche keine Spalte der Treibertabelle sind, sodass Tippfehler vor der Ausführung des Schritts auffallen.

Zeile 1 testen liest die erste Treiberzeile (unter Beachtung des Treiberfilters), setzt ihre Werte in Endpunkt, Abfrage, Header und Body ein und sendet diese eine Anfrage – so können Sie bestätigen, dass der Fan-out richtig verdrahtet ist, bevor Sie ihn über alle Zeilen ausführen. Die Antwort wird wie bei Testanfrage senden inline angezeigt, zusammen mit den verwendeten Werten der Treiberzeile. Zeile 1 in der Vorschau anzeigen löst ebenso die Werte {{row.column}} der ersten Treiberzeile auf und zeigt die aufgelöste Anfrage, ohne sie zu senden.

Den Schritt ausführen

Der Schritt REST-Anfrage wird wie jeder andere ausgeführt – als Teil einer vollständigen Ausführung oder einzeln (siehe Einen einzelnen Schritt in einem Workflow ausführen). Im Tabellenmodus schreibt er die geparste (oder rohe) Antwort in die Zieltabelle; im Variablenmodus setzt er die vier Variablen, die spätere Schritte lesen können.

Nächste Schritte

Referenz zum Schritt REST-Anfrage – kompakte Feldliste
Workflow-Variablen verwalten – Variablen über Schritte hinweg lesen und setzen
REST-Verbindungen – authentifizierte API-Verbindungen einrichten