Przejdź do głównej zawartości

Węzeł api

Ten węzeł umożliwia interakcję z różnymi API, co jest przydatne do integracji z zewnętrznymi usługami.

Ustawienia węzła API​

IMG2

1. Nazwa​

Pole do podania nazwy węzła.
Nazwa jest wyświetlana w obszarze roboczym i pomaga łatwo zidentyfikować węzeł.
Jeśli pozostawisz puste, węzeł będzie nazywał się API.

Przykład:

  • Nazwa węzła: Utwórz sesję płatności

2. Metoda​

Tutaj wybierana jest metoda API, która będzie używana do wysyłania żądania. Dostępne metody:

  • "Utwórz sesję płatności":
    Tworzy nową sesję płatności.

  • "Zaktualizuj sesję płatności":
    Aktualizuje istniejącą sesję płatności.

  • "Pobierz sesję płatności po ID":
    Pobiera informacje o sesji płatności na podstawie unikalnego identyfikatora sesji.

  • "Pobierz sesję płatności po ID zamówienia":
    Pobiera informacje o sesji płatności, używając identyfikatora zamówienia.

Przykład:

  • Metoda: Utwórz sesję płatności

3. Dane​

To pole wykorzystuje szablon Mustache do formowania danych żądania w formacie JSON.
Możesz używać danych z wiadomości msg do podstawiania wartości w szablonie.

Przykład szablonu (dla metody "Utwórz sesję płatności"):

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

W tym przykładzie wartość orderId będzie podstawiana z wiadomości msg.

Przykład szablonu (dla metody "Zaktualizuj sesję płatności"):

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

Przy użyciu szablonów Mustache możesz przekazywać złożone dane i parametry potrzebne do interakcji z API.

Przykłady żądań​

Przykład 1: Utworzenie sesji płatności​

Ustawienia węzła:

  • Metoda: Utwórz sesję płatności
  • Dane: 
    {
      "orderId": {{orderId}},
      "type": "session"
    }

Wiadomość:

{
  "orderId": 123
}

Wynik:
Węzeł wyśle żądanie utworzenia sesji płatności z danymi z wiadomości. W rezultacie zostaną uzyskane informacje o nowej sesji płatności.

Przykład 2: Aktualizacja sesji płatności​

Ustawienia węzła:

  • Metoda: Zaktualizuj sesję płatności
  • Dane: 
    {
      "id": {{paymentSessionId}},
      "paymentUrl": "{{{payload.links.1.href}}}"
    }

Wiadomość:

{
  "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"
      }
    ]
  }
}

Wynik:
Węzeł wyśle żądanie aktualizacji statusu sesji płatności, używając podanych wartości payment_session_id i status.

Przykład 3: Pobranie sesji płatności po ID​

Ustawienia węzła:

  • Metoda: Pobierz sesję płatności po ID
  • Dane: 
    {
      "id": "{{paymentSessionId}}"
    }

Wiadomość:

{
  "paymentSessionId": 123
}

Wynik:
Węzeł wyśle żądanie pobrania informacji o sesji płatności na podstawie unikalnego identyfikatora sesji.

Przykład 4: Pobranie sesji płatności po ID zamówienia​

Ustawienia węzła:

  • Metoda: Pobierz sesję płatności po ID zamówienia
  • Dane: 
    {
      "orderId": "{{payload.id}}"
    }

Wiadomość:

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

Wynik:
Węzeł wyśle żądanie pobrania informacji o sesji płatności związanej z podanym identyfikatorem zamówienia.