Zum Hauptinhalt springen

Knoten api

Dieser Knoten ermöglicht die Interaktion mit verschiedenen APIs, was nützlich für die Integration mit externen Diensten ist.

Einstellungen des Knotens API​

IMG2

1. Name​

Feld zur Angabe des Knotennamens.
Der Name wird im Arbeitsbereich angezeigt und hilft, den Knoten leicht zu identifizieren.
Wenn es leer gelassen wird, wird der Knoten API genannt.

Beispiel:

  • Knotenname: Create Payment Session

2. Method​

Hier wird die API-Methode ausgewählt, die zum Senden der Anfrage verwendet wird. Verfügbare Methoden:

  • "Create Payment Session" (Zahlungssitzung erstellen):
    Erstellt eine neue Zahlungssitzung.

  • "Update Payment Session" (Zahlungssitzung aktualisieren):
    Aktualisiert eine bestehende Zahlungssitzung.

  • "Get Payment Session by ID" (Zahlungssitzung nach ID abrufen):
    Ruft Informationen über die Zahlungssitzung anhand der eindeutigen Sitzungs-ID ab.

  • "Get Payment Session by Order ID" (Zahlungssitzung nach Bestell-ID abrufen):
    Ruft Informationen über die Zahlungssitzung unter Verwendung der Bestell-ID ab.

Beispiel:

  • Methode: Create Payment Session

3. Data​

Dieses Feld verwendet die Mustache-Vorlage zur Erstellung der Anfrage-Daten im JSON-Format.
Sie können Daten aus der Nachricht msg verwenden, um Werte in die Vorlage einzufügen.

Beispielvorlage (für die Methode "Create Payment Session"):

 {
   "orderId": {{orderId}},
   "type": "session"
 }

In diesem Beispiel wird der Wert orderId aus der Nachricht msg eingefügt.

Beispielvorlage (für die Methode "Update Payment Session"):

 {
   "id": {{paymentSessionId}},
   "paymentUrl": "{{{payload.links.1.href}}}"
 }

Bei der Verwendung von Mustache-Vorlagen können Sie komplexe Daten und Parameter übergeben, die für die Interaktion mit der API erforderlich sind.

Beispiele für Anfragen​

Beispiel 1: Erstellung einer Zahlungssitzung​

Einstellungen des Knotens:

  • Method (Methode): Create Payment Session
  • Data (Daten): 
    {
      "orderId": {{orderId}},
      "type": "session"
    }

Nachricht:

{
  "orderId": 123
}

Ergebnis:
Der Knoten sendet eine Anfrage zur Erstellung einer Zahlungssitzung mit den Daten aus der Nachricht. Infolgedessen werden Informationen über die neue Zahlungssitzung erhalten.

Beispiel 2: Aktualisierung einer Zahlungssitzung​

Einstellungen des Knotens:

  • Method (Methode): Update Payment Session
  • Data (Daten): 
    {
      "id": {{paymentSessionId}},
      "paymentUrl": "{{{payload.links.1.href}}}"
    }

Nachricht:

{
  "paymentSessionId": 123,
  "payload": {
    "id": "8YP51523N05861826",
    ....
    "links": [
      {
        "href": "https://api.sandbox.paypal.com/v2/checkout/orders/8YP51523N05861826",
        "rel": "self",
        "method": "GET"
      },
      {
        "href": "https://www.sandbox.paypal.com/checkoutnow?token=8YP51523N05861826",
        "rel": "payer-action",
        "method": "GET"
      }
    ]
  }
}

Ergebnis:
Der Knoten sendet eine Anfrage zur Aktualisierung des Status der Zahlungssitzung unter Verwendung der bereitgestellten Werte payment_session_id und status.

Beispiel 3: Abrufen einer Zahlungssitzung nach ID​

Einstellungen des Knotens:

  • Method (Methode): Get Payment Session by ID
  • Data (Daten): 
    {
      "id": "{{paymentSessionId}}"
    }

Nachricht:

{
  "paymentSessionId": 123
}

Ergebnis:
Der Knoten sendet eine Anfrage zum Abrufen von Informationen über die Zahlungssitzung anhand der eindeutigen Sitzungs-ID.

Beispiel 4: Abrufen einer Zahlungssitzung nach Bestell-ID​

Einstellungen des Knotens:

  • Method (Methode): Get Payment Session by Order ID
  • Data (Daten): 
    {
      "orderId": "{{payload.id}}"
    }

Nachricht:

{
  "payload": {
    "id": 1
  }
}

Ergebnis:
Der Knoten sendet eine Anfrage zum Abrufen von Informationen über die Zahlungssitzung, die mit der angegebenen Bestell-ID verknüpft ist.