http

Mit der Aktivität HTTP request können Sie JSON-basierte API-Anforderungen in Ihrem Workflow ausführen. Sie können den generischen HTTP-Connector oder einen der unterstützten Integration Service-Connectors für die Authentifizierung verwenden oder die Aktivität ohne Verbindung verwenden und Authentifizierungsdetails direkt in der Anforderung angeben.

Die Aktivität bietet volle Kontrolle über die Anforderungskonfiguration und ermöglicht die dynamische Definition von Methoden, URLs, Headern und Textinhalten. Nach der Ausführung stehen die Antwortdaten als Referenz in nachfolgenden Workflow-Schritten zur Verfügung, was sie zu einer kritischen Komponente für die Interaktion mit externen APIs macht.

Hinweis:

Sie können Autopilot nutzen, um die HTTP-Anforderung für Sie hinzuzufügen, indem Sie die gewünschte cURL in den Chat einfügen.

Verwenden der HTTP-Aktivität

So fügen Sie Ihrem Workflow eine HTTP Request- Aktivität hinzu:

1. Wählen Sie auf der Arbeitsfläche Ihres API-Workflow-Designers das Pluszeichen (+) aus. Das Menü Aktivität hinzufügen wird angezeigt.
2. Wählen Sie HTTP aus.
3. Konfigurieren Sie im Eigenschaftenbereich die folgenden Felder:
   • Authentifizierung– Der zu verwendende Authentifizierungstyp, entweder Manuelle Authentifizierung oder Connector-basierte Authentifizierung.
   • Connector– Wenn Sie die Connector-basierte Authentifizierung ausgewählt haben, wählen Sie den zu verwendenden Connector aus.
   • Verbindung– Die im Integration Service hergestellte Verbindung. Wählen Sie eine vorhandene Verbindung aus, klicken Sie auf + Verbindung , um eine neue Verbindung hinzuzufügen, oder klicken Sie auf Verbindungen öffnen, um Verbindungen zu verwalten.
   • Methode– Die HTTP-Methode für die Anforderung, GET, POST, PATCH, DELETE, PUT, OPTIONS oder HEAD.
   • Anforderungs-URL– Der API-Endpunkt für die Anforderung. Sie können URLs dynamisch mit dem Ausdrucks-Editor erstellen. Zum Beispiel das Anfügen einer ID, die aus einem vorherigen Workflow-Schritt abgerufen wurde. Wenn eine Basis-URL festgelegt ist, geben Sie einen relativen Pfad ein. Um sie zu überschreiben, verwenden Sie eine absolute URL mit derselben Basisdomäne.
   • Header– Die Header der Anforderung als Schlüssel-Wert-Paare. Header verwenden ein JSON-Objektformat und können dynamisch mit dem Ausdrucks-Editor generiert werden. Zum Beispiel:

     {
       "Content-Type": "application/json",
       "Accept": "application/json",
       "Authorization": "Bearer jfio**********"
     }
     

   • Abfrageparameter– Die Abfrageparameter. Verwenden Sie den Wörterbuch-Editor , um neue Parameter hinzuzufügen.
     • Beispiel: query value "select * from Vendor" (für QuickBooks Online).
   • Textkörper– Verfügbar für alle HTTP-Methoden, außer GET, OPTIONS und HEAD. Unterstützt JSON-basierte Nutzlasten, sodass Sie mit dem Ausdruckseditor auf Daten aus vorherigen Schrittausgaben verweisen können.
4. Debuggen Sie den Workflow, um die Aktivität auszuführen und Ausgabefelder für die spätere Verwendung zu generieren.

Beispiel für eine HTTP-Aktivität

Im folgenden Beispiel wird eine POST-Anforderung an HTTPBin gestellt, wodurch die Anforderungsdaten zur Validierung zurückgegeben werden. Die Anforderung enthält dynamische Pfadvariablen, Header und einen strukturierten Anforderungstext.

Öffnen Sie das Fenster Konfiguration debuggen , und fügen Sie dann die folgende JSON-Syntax in den Abschnitt Projektargumente ein und speichern Sie sie:

{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-24T10:30:00Z",
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}

1. Fügen Sie auf der Arbeitsfläche Ihres API-Workflowdesigners eine Skriptaktivität hinzu, um einen Bearer-Tokenwert auszugeben:

   1. Öffnen Sie den Ausdrucks-Editor und geben Sie ein JSON-Objekt mit einer Eigenschaft namens Bearer_token zurück:

      return {
          "bearer_token": "123321123321"
      }
      

   2. Speichern.

2. Fügen Sie eine HTTP- Aktivität zur Entwurfs-Canvas hinzu.

3. Konfigurieren Sie die HTTP- Aktivität wie folgt:

   • Methode– POST
   • Anforderungs-URL– Verwenden Sie den Ausdruckseditor, um die URL-Zeichenfolge mit einer ID- Pfad-Variablen zu erstellen:

     "https://www.httpbin.org/anything/" + ($workflow.input.id)
     

   • Header– Fügen Sie Header hinzu, indem Sie eine einfache Schlüssel-Wert-JSON angeben. Sie simulieren auch den Prozess zum Hinzufügen eines Bearer-Tokens als Autorisierungsheader:

     {
         "Accept": "application/json",
         "Content-Type": "application/json",
         "Authorization": ("Bearer " + $context.outputs.Javascript_3.bearer_token)
     }
     

   • Anforderungstext– Verwenden Sie den Ausdrucks-Editor, um den Anforderungstext dynamisch zu erstellen, indem Sie auf Ihre Ausführungskonfigurations-JSON verweisen. Das Ziel besteht darin, ein Array von Transaktionen, die in ein Objekt eingeschlossen sind, als Anforderungsnutzlast zu übergeben:

     {
         "transactions": $workflow.input.transactions
     }
     

   Beachten Sie, dass das Panel Ausdrucksausgabe zeigt, wie die endgültige JSON basierend auf den Eingabedaten des Aktivitätstests aussehen sollte:

   

4. Debuggen Sie den Workflow, um die Aktivität auszuführen.

5. Überprüfen Sie das Panel Ausgabe , um die HTTP-Antwort zu überprüfen.