Call x402 Endpoint
Call an x402 pay-per-use API endpoint. Payment is handled automatically using your connected wallet — no manual steps needed.
Hành động tích hợp sẵn X402 wallet
Gọi một điểm cuối API x402 theo mô hình trả phí theo sử dụng. Thanh toán được xử lý tự động bằng ví đã kết nối của bạn — không cần các bước thủ công.
Hành động này có thể yêu cầu kết nối ví, gas, chuyển động token hoặc một tác dụng phụ bên ngoài. Hãy kiểm tra bằng mô phỏng hoặc số lượng kiểm soát trước khi sử dụng trong quy trình trực tiếp.
Tổng quan
| Trường | Giá trị |
|---|---|
| ID Hành động | call-x402-endpoint |
| Danh mục | X402 |
| Kết nối | wallet |
| Yêu cầu gas | Không |
| Chuyển động quỹ | Không khai báo |
| Thẻ | x402, payment, api, pay-per-call |
Sơ đồ Payload
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
endpointId | string | Có | ID của điểm cuối x402 để gọi (từ sổ đăng ký điểm cuối) |
maxPrice | string | Không | Ghi đè tùy chọn cho giá tối đa cho phép (theo đơn vị nhỏ nhất của token). Nếu không chỉ định, sử dụng giá tối đa mặc định của điểm cuối. |
Sơ đồ Kết quả
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
status | string | Có | Trạng thái yêu cầu thành công hay thất bại |
statusCode | number | Không | Mã trạng thái HTTP từ phản hồi |
resource | object | Không | Dữ liệu tài nguyên đã lấy (phản hồi JSON đã phân tích từ điểm cuối). Truy cập các trường lồng nhau bằng {{nodeId.result.resource.fieldName}} |
paymentDetails | object | Không | Chi tiết giao dịch thanh toán |
requestDetails | object | Không | Chi tiết của yêu cầu đã thực hiện |
responseHeaders | object | Không | Tiêu đề phản hồi từ máy chủ tài nguyên |
error | string | Không | Thông báo lỗi nếu thất bại |
Ví dụ
json{ "type": "call-x402-endpoint", "payload": { "endpointId": "x402_abc123" }, "children": [], "connector": { "type": "wallet", "id": "conn_wallet" }}
bashcurl -X POST "https://api.b3os.org/v1/actions/call-x402-endpoint/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "endpointId": "x402_abc123" }}'
Các trường payload có thể sử dụng các biểu thức workflow như {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, và {{$props.asset}} khi giá trị cần lấy từ trigger, nút trước đó, hoặc prop của workflow có thể tái sử dụng.