Ana içeriğe geç

API Düğümü

Bu düğüm, dış hizmetlerle entegrasyon için yararlı olan çeşitli API'lerle etkileşimde bulunmayı sağlar.

API Düğümü Ayarları​

IMG2

1. İsim​

Düğümün adını belirtmek için bir alan.
İsim, çalışma alanında görüntülenir ve düğümü kolayca tanımlamaya yardımcı olur.
Boş bırakılırsa, düğüm API olarak adlandırılacaktır.

Örnek:

  • Düğüm adı: Ödeme Oturumu Oluştur

2. Yöntem​

Burada, isteği göndermek için kullanılacak API yöntemi seçilir. Mevcut yöntemler:

  • "Ödeme Oturumu Oluştur":
    Yeni bir ödeme oturumu oluşturur.

  • "Ödeme Oturumunu Güncelle":
    Mevcut bir ödeme oturumunu günceller.

  • "ID ile Ödeme Oturumunu Al":
    Ödeme oturumunun bilgilerini oturumun benzersiz kimliği ile alır.

  • "Sipariş ID ile Ödeme Oturumunu Al":
    Sipariş kimliğini kullanarak ödeme oturumunun bilgilerini alır.

Örnek:

  • Yöntem: Ödeme Oturumu Oluştur

3. Veri​

Bu alan, JSON formatında istek verilerini oluşturmak için Mustache şablonunu kullanır.
Şablona değerleri yerleştirmek için msg mesajından verileri kullanabilirsiniz.

Şablon örneği (Ödeme Oturumu Oluştur yöntemi için):

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

Bu örnekte orderId değeri msg mesajından yerleştirilecektir.

Şablon örneği (Ödeme Oturumunu Güncelle yöntemi için):

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

Mustache şablonları kullanarak, API ile etkileşim için gerekli karmaşık verileri ve parametreleri iletebilirsiniz.

İstek Örnekleri​

Örnek 1: Ödeme Oturumu Oluşturma​

Düğüm Ayarları:

  • Yöntem: Ödeme Oturumu Oluştur
  • Veri: 
    {
      "orderId": {{orderId}},
      "type": "session"
    }

Mesaj:

{
  "orderId": 123
}

Sonuç:
Düğüm, mesajdan gelen verilerle bir ödeme oturumu oluşturmak için istek gönderecektir. Sonuç olarak yeni bir ödeme oturumu hakkında bilgi alınacaktır.

Örnek 2: Ödeme Oturumunu Güncelleme​

Düğüm Ayarları:

  • Yöntem: Ödeme Oturumunu Güncelle
  • Veri: 
    {
      "id": {{paymentSessionId}},
      "paymentUrl": "{{{payload.links.1.href}}}"
    }

Mesaj:

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

Sonuç:
Düğüm, sağlanan payment_session_id ve status değerlerini kullanarak ödeme oturumunun durumunu güncellemek için istek gönderecektir.

Örnek 3: ID ile Ödeme Oturumunu Alma​

Düğüm Ayarları:

  • Yöntem: ID ile Ödeme Oturumunu Al
  • Veri: 
    {
      "id": "{{paymentSessionId}}"
    }

Mesaj:

{
  "paymentSessionId": 123
}

Sonuç:
Düğüm, oturumun benzersiz kimliği ile ödeme oturumunun bilgilerini almak için istek gönderecektir.

Örnek 4: Sipariş ID ile Ödeme Oturumunu Alma​

Düğüm Ayarları:

  • Yöntem: Sipariş ID ile Ödeme Oturumunu Al
  • Veri: 
    {
      "orderId": "{{payload.id}}"
    }

Mesaj:

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

Sonuç:
Düğüm, belirtilen sipariş kimliği ile ilişkili ödeme oturumunun bilgilerini almak için istek gönderecektir.