Avola API 接口文档｜把服务接入你的网站

快速开始

前往我的账户 → 开发者 API 创建密钥。完整密钥只显示一次。

只能在服务器端使用：不要把 API 密钥写入浏览器 JavaScript、HTML、手机安装包或公开代码仓库。

curl -X POST https://avola.uk/api/v1 \
  -d "key=avola_live_你的密钥" \
  -d "action=services"

支持表单和 JSON 请求，也可以使用 Authorization: Bearer 密钥。

官方 Agent CLI v1.0

AI Agent 和服务器自动化可以使用零依赖的 Avola Agent CLI。工具从 AVOLA_API_KEY 读取密钥，并以 JSON 返回服务、余额、下单结果和订单状态。

# PowerShell
$env:AVOLA_API_KEY="avola_live_你的密钥"
node .\avola-agent.mjs doctor

查看 Agent CLI 文档

读取服务列表

参数	值
key	API 密钥
action	`services`

[
  {
    "service": 12345678,
    "name": "X Post Views — 1,000 views",
    "type": "Package",
    "category": "X / Twitter",
    "rate": "0.29",
    "min": "1",
    "max": "1",
    "currency": "USD"
  }
]

接口只返回 Avola 对外服务编号和公开售价。建议定期刷新服务列表，不要永久缓存价格。

提交订单

参数	说明
key	API 密钥
action	`add`
service	`services` 返回的服务编号
link	公开可访问的目标链接
request_id	可选；你方系统的唯一幂等编号，防止重复下单
notes	可选；公开任务说明

curl -X POST https://avola.uk/api/v1 \
  -d "key=avola_live_你的密钥" \
  -d "action=add" \
  -d "service=12345678" \
  -d "link=https://x.com/example/status/123" \
  -d "request_id=store-order-1001"

{"order":"AVO20260714ABCD","charge":"0.29","status":"In progress","currency":"USD"}

订单受理后会从密钥关联的 Avola 余额扣款。如果标准化交付提交失败，订单金额会自动退回 Avola 余额。

查询订单状态

action	`status`
order	单个 Avola 订单号
orders	可选；逗号分隔，最多 100 个订单号

curl -X POST https://avola.uk/api/v1 \
  -d "key=avola_live_你的密钥" \
  -d "action=status" \
  -d "order=AVO20260714ABCD"

{"charge":"0.29","start_count":"0","status":"In progress","remains":"1000","currency":"USD"}

查询余额

action balance

{"balance":"43.57","currency":"USD"}

安全与错误

错误会以 JSON 返回，例如 {"error":"Invalid API key"}。接口有访问频率限制；密钥泄露后应立即在账户中撤销。每个密钥只能读取关联账户的余额和订单。

Avola API 不会返回供应商名称、供应商服务编号、供应商价格、内部成本、管理备注或任何凭证。

创建 API 密钥