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 与 MCP v1.0.1

AI Agent 和服务器自动化可以使用零依赖的 Avola Agent CLI 或本地 stdio MCP。两者都从 AVOLA_API_KEY 读取密钥。MCP 默认只预览订单，只有 JSON 布尔值 confirm: true 才会执行下单。

# PowerShell
$env:AVOLA_API_KEY="avola_live_你的密钥"
node .\avola-agent.mjs doctor
# MCP：node C:\绝对路径\avola-mcp.mjs

查看 Agent CLI 与 MCP 文档

读取服务列表

参数	值
key	API 密钥
action	`services`

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

接口只返回 Avola 对外服务编号和公开售价。选择套餐前请刷新列表；套餐选项调整后，编号可能变化。每个服务编号对应一个固定套餐：min 和 max 均为 1，rate 是以美元计价的套餐总价，并非每千次单价。

提交订单

参数	说明
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.19","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.19","start_count":"0","status":"In progress","remains":"1000","currency":"USD"}

活动任务已发布时仍返回 In progress，只有订单状态变为完成后才返回 Completed。当前接口的 start_count 固定为 0；remains 返回记录的交付数量，完成订单返回 0。这两个字段不代表实时参与者进度，活动完成仍应按任务证据要求核对。

查询余额

action balance

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

安全与错误

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

Avola API 返回公开的 Avola 服务字段和关联账户的数据。请妥善保管 API 密钥。

创建 API 密钥