基礎 URL
開發和測試請使用 sandbox URL。僅在準備好使用真實資金進行交易時才切換至 production。
身份驗證
所有 API 請求必須包含以下其中一個身份驗證標頭:| 方式 | 標頭 | 範例 |
|---|---|---|
| API Key | X-API-Key | X-API-Key: awx_your_api_key |
| JWT Bearer | Authorization | Authorization: Bearer eyJhbGciOi... |
分頁
所有列表端點都支援以下查詢參數的分頁:| 參數 | 預設值 | 最大值 | 說明 |
|---|---|---|---|
page_num | 1 | — | 頁碼(從 1 開始) |
page_size | 20 | 100 | 每頁項目數 |
錯誤規範
所有錯誤遵循一致的格式:錯誤類型
| 類型 | HTTP 狀態碼 | 說明 |
|---|---|---|
invalid_request_error | 400 | 無效的請求主體或參數 |
authentication_error | 401 | 缺少或無效的憑證 |
authorization_error | 403 | 權限不足 |
not_found_error | 404 | 資源不存在 |
rate_limit_error | 429 | 超過速率限制 |
internal_error | 500 | 伺服器端錯誤 |
API 區段
代理
建立和管理 AI 代理錢包。
交易
發送付款和查詢交易歷史。
策略
配置支出限額和存取控制。
Webhooks
註冊和管理 webhook 端點。
x402 Pay
觸發 x402 微型支付協商。
x402 Sessions
管理 x402 工作階段預算。