Nhảy tới nội dung

Node api

Node này cho phép tương tác với các API khác nhau, điều này rất hữu ích cho việc tích hợp với các dịch vụ bên ngoài.

Cài đặt Node API​

IMG2

1. Tên​

Trường để chỉ định tên của node.
Tên được hiển thị trong không gian làm việc và giúp dễ dàng xác định node.
Nếu để trống, node sẽ được gọi là API.

Ví dụ:

  • Tên node: Tạo Phiên Thanh Toán

2. Phương thức​

Tại đây, phương thức API sẽ được sử dụng để gửi yêu cầu được chọn. Các phương thức có sẵn:

  • "Tạo Phiên Thanh Toán":
    Tạo một phiên thanh toán mới.

  • "Cập Nhật Phiên Thanh Toán":
    Cập nhật một phiên thanh toán hiện có.

  • "Lấy Phiên Thanh Toán theo ID":
    Lấy thông tin về phiên thanh toán theo định danh phiên duy nhất.

  • "Lấy Phiên Thanh Toán theo ID Đơn Hàng":
    Lấy thông tin về phiên thanh toán bằng cách sử dụng định danh đơn hàng.

Ví dụ:

  • Phương thức: Tạo Phiên Thanh Toán

3. Dữ liệu​

Trường này sử dụng mẫu Mustache để hình thành dữ liệu yêu cầu ở định dạng JSON.
Bạn có thể sử dụng dữ liệu từ tin nhắn msg để thay thế các giá trị trong mẫu.

Ví dụ mẫu (cho phương thức "Tạo Phiên Thanh Toán"):

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

Trong ví dụ này, giá trị của orderId sẽ được thay thế từ tin nhắn msg.

Ví dụ mẫu (cho phương thức "Cập Nhật Phiên Thanh Toán"):

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

Khi sử dụng các mẫu Mustache, bạn có thể truyền dữ liệu và tham số phức tạp cần thiết để tương tác với API.

Ví dụ Yêu Cầu​

Ví dụ 1: Tạo một Phiên Thanh Toán​

Cài đặt Node:

  • Phương thức: Tạo Phiên Thanh Toán
  • Dữ liệu: 
    {
      "orderId": {{orderId}},
      "type": "session"
    }

Tin nhắn:

{
  "orderId": 123
}

Kết quả:
Node sẽ gửi một yêu cầu để tạo một phiên thanh toán với dữ liệu từ tin nhắn. Kết quả là thông tin về phiên thanh toán mới sẽ được nhận.

Ví dụ 2: Cập Nhật một Phiên Thanh Toán​

Cài đặt Node:

  • Phương thức: Cập Nhật Phiên Thanh Toán
  • Dữ liệu: 
    {
      "id": {{paymentSessionId}},
      "paymentUrl": "{{{payload.links.1.href}}}"
    }

Tin nhắn:

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

Kết quả:
Node sẽ gửi một yêu cầu để cập nhật trạng thái của phiên thanh toán bằng cách sử dụng các giá trị payment_session_id và status đã cung cấp.

Ví dụ 3: Lấy một Phiên Thanh Toán theo ID​

Cài đặt Node:

  • Phương thức: Lấy Phiên Thanh Toán theo ID
  • Dữ liệu: 
    {
      "id": "{{paymentSessionId}}"
    }

Tin nhắn:

{
  "paymentSessionId": 123
}

Kết quả:
Node sẽ gửi một yêu cầu để lấy thông tin về phiên thanh toán theo định danh phiên duy nhất.

Ví dụ 4: Lấy một Phiên Thanh Toán theo ID Đơn Hàng​

Cài đặt Node:

  • Phương thức: Lấy Phiên Thanh Toán theo ID Đơn Hàng
  • Dữ liệu: 
    {
      "orderId": "{{payload.id}}"
    }

Tin nhắn:

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

Kết quả:
Node sẽ gửi một yêu cầu để lấy thông tin về phiên thanh toán liên quan đến định danh đơn hàng đã chỉ định.