Node admin-api
Node này cho phép tương tác với nhiều 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 admin-api
1. Tên
Một trường để chỉ định tên của node.
Tên sẽ được hiển thị trong không gian làm việc và giúp dễ dàng nhận diện node.
Nếu để trống, node sẽ được gọi là admin-api
.
Ví dụ:
- Tên node:
Tạo Phiên Thanh Toán
2. Loại
Tại đây, bạn chọn phương thức API sẽ được sử dụng để gửi yêu cầu. Các phương thức có sẵn:
-
"Cập nhật đối tượng trang":
-
"Tìm kiếm tất cả đối tượng trên các trang sản phẩm với phân trang cho danh mục đã chọn":
-
"Thay đổi trạng thái của trang sản phẩm":
-
"Cập nhật trang sản phẩm":
-
"Cập nhật đối tượng người dùng - quản trị viên":
-
"Cập nhật một đối tượng người dùng":
-
"Cập nhật giá trị của một thuộc tính thực thể":
-
"Nhận tất cả đơn hàng thuộc về đối tượng lưu trữ đơn hàng":
-
"Cập nhật trạng thái của một đơn hàng thuộc về đối tượng lưu trữ đơn hàng":
-
"Cập nhật phiên thanh toán":
-
"Nhận một đối tượng phiên thanh toán theo định danh của nó":
-
"Tạo một phiên thanh toán":
-
"Nhận tất cả bản ghi thuộc về bộ sưu tập":
-
"Tạo một bản ghi trong bộ sưu tập":
-
"Thay đổi một bản ghi trong bộ sưu tập":
-
"Xóa một đối tượng khỏi bản ghi bộ sưu tập":
3. Tham số truy vấn
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ị vào mẫu.
Ví dụ mẫu (cho phương thức "Nhận tất cả bản ghi thuộc về bộ sưu tập"):
{
"entityType": "orders",
"entityId": "{{orderId}}",
"langCode": "en_US",
"offset": 0,
"limit": 1,
"marker": "delivery"
}
Trong ví dụ này, giá trị của orderId
sẽ được thay thế từ tin nhắn msg
.
Khi sử dụng các mẫu Mustache, bạn có thể truyền dữ liệu phức tạp và các tham số cần thiết để tương tác với API.
4. Nội dung yêu cầ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ị vào mẫu.
Ví dụ mẫu (cho phương thức "Tạo một 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
.
Khi sử dụng các mẫu Mustache, bạn có thể truyền dữ liệu phức tạp và các tham số 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:
- Loại:
Tạo một phiên thanh toán
- Nội dung yêu cầu:
{
"orderId": {{orderEvent.order.id}},
"type": "session"
}
Kết quả:
Node sẽ gửi 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:
- Loại:
Cập nhật phiên thanh toán
- Tham số truy vấn:
{
"id": {{paymentSessionId}}
} - Nội dung yêu cầu:
{
"status": "{{status}}"
}
Kết quả:
Node sẽ gửi yêu cầu để cập nhật trạng thái của phiên thanh toán, sử dụng các giá trị đã cung cấp paymentSessionId
và status
.