Chuyển đến nội dung chính

URL Cơ sở

Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
Sử dụng URL sandbox cho phát triển và thử nghiệm. Chỉ chuyển sang production khi bạn sẵn sàng giao dịch với quỹ thực.

Xác thực

Tất cả yêu cầu API phải bao gồm một trong các header xác thực sau:
Phương thứcHeaderVí dụ
API KeyX-API-KeyX-API-Key: awx_your_api_key
JWT BearerAuthorizationAuthorization: Bearer eyJhbGciOi...
# API key authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "X-API-Key: awx_your_api_key"

# JWT authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "Authorization: Bearer eyJhbGciOi..."
Xem Xác thực để biết chi tiết đầy đủ về cách lấy và quản lý thông tin xác thực.

Phân trang

Tất cả endpoint danh sách hỗ trợ phân trang với các tham số truy vấn sau:
Tham sốMặc địnhTối đaMô tả
page_num1Số trang (bắt đầu từ 1)
page_size20100Số mục trên mỗi trang
Định dạng phản hồi:
{
  "data": [],
  "total": 42,
  "has_more": true
}

Hợp đồng Lỗi

Tất cả lỗi tuân theo định dạng nhất quán:
{
  "code": "invalid_request",
  "type": "invalid_request_error",
  "message": "human readable error description"
}

Các Loại Lỗi

LoạiMã HTTPMô tả
invalid_request_error400Nội dung yêu cầu hoặc tham số không hợp lệ
authentication_error401Thiếu hoặc thông tin xác thực không hợp lệ
authorization_error403Không đủ quyền
not_found_error404Tài nguyên không tồn tại
rate_limit_error429Vượt quá giới hạn tốc độ
internal_error500Lỗi phía server
Xem Xử lý Lỗi để biết hướng dẫn chi tiết về cách xử lý lỗi.

Các Mục API

Tác nhân

Tạo và quản lý ví tác nhân AI.

Giao dịch

Gửi thanh toán và truy vấn lịch sử giao dịch.

Chính sách

Cấu hình giới hạn chi tiêu và kiểm soát truy cập.

Webhook

Đăng ký và quản lý endpoint webhook.

x402 Pay

Kích hoạt thương lượng thanh toán nhỏ x402.

Phiên x402

Quản lý ngân sách phiên x402.