http

Die HTTP- Aktivität ermöglicht es Ihnen, JSON-basierte API-Anforderungen in Ihrem Workflow auszuführen. Er 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.

Bekannte Einschränkungen

• Unterstützt keine über Integration Service konfigurierten Verbindungen. Um vorhandene Authentifizierung oder Verbindungen von einem Connector zu verwenden, verwenden Sie die Aktivität Connector und wählen Sie die Aktivität HTTP Request in diesem Connector aus.
• Unterstützt nur JSON-basierte Anforderungen und Antworten. Stellen Sie sicher, dass Ihre Anforderungen Header enthalten, z. B. Content-Type: application/json und Accept: application/json.

Verwenden der HTTP-Aktivität

So fügen Sie Ihrem Workflow eine HTTP- 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:
   • Methode– Gibt die HTTP-Methode für die Anforderung an, z. B. GET, POST, PATCH, DELETE oder PUT.
   • Anforderungs-URL– Definiert den 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.
   • Header– Definiert 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**********"
     }

   • Anforderungstext– Verfügbar für alle HTTP-Methoden außer GET 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 | tostring)

   • 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.