AQNAB API 接入指南

经销商可用统一接口同步目录、创建订单和跟踪进度。公开文档不包含密钥,下单使用账户余额;请在服务端保存密钥。

服务同步与下单

  1. 调用 services 获取服务 ID、每千价、最小和最大数量、补量标签与链接格式。
  2. 根据服务类型填写公开主页或指定内容链接,调用 add 提交。下单会再次校验数量、链接与余额。
  3. 保存返回的 AQNAB 订单号,调用 status 查看真实上游同步后的状态、起始数量及剩余数量。
  4. 超时或结果不确定时先查询并人工核对,不直接换线路重复下单。只有确认未接单后,才能选择其他服务重新提交。

最小调用示例

curl -X POST https://aqnab.com/api/v2 -d 'key=YOUR_API_KEY' -d 'action=services'

接口:POST /api/v2;接受表单或 JSON,返回 JSON。余额查询 action=balance;下单 action=add,传 service、link、quantity;查进度 action=status,传 order。自定义评论另传 comments,关键词服务另传 keywords。

补量、取消与分站采购

status 支持 orders 批量查询(最多100单);refill 传 order 或 orders,refill_status 传 refill 或 refills;cancel 传 orders。补量及取消仅在服务支持时接受,申请进入异步队列,取消申请不等于已退款。

各分站 API 接入页提供独立密钥。分站密钥使用你在该供货站预充值的采购余额,按本站报价下单;不使用其他站或主站余额。各级采购余额不足时拒绝整笔扣款。客户充值进入该供货站配置的收款账户。

博客发布、目录和图片接口

代理发布接口支持创建草稿、预览、修改、发布、列表和删除,使用独立发布密钥,限定到主站或指定分站。请先测试草稿再发布正式文章。

查看完整代理接口文档与字段表 →

密钥管理

AQNAB API V2

开发者接口文档

从服务目录获取编号和当前账户售价,再用同一个密钥下单与查单。

HTTP 方法
POST
接口地址
https://aqnab.com/api/v2
请求格式
JSON 或表单(application/x-www-form-urlencoded)
响应格式
JSON · 计价单位 USD
认证方式
请求体中传 key。密钥只保存在服务端。

申请补量 refill

仅支持标记 refill=true 且已提交给上游的本账户订单。申请先进入队列;供应商响应不明时等待核对,不重复提交。orders 可批量传1–100个订单号。

参数类型说明
key字符串必填。你的 AQNAB API Key。
action字符串必填。固定为 refill。
order字符串单个订单号;批量使用 orders,逗号分隔。
请求体(JSON)
{
  "key": "YOUR_KEY",
  "action": "refill",
  "order": "API-EXAMPLE-4ABC"
}
成功响应示例
{
  "refill": "AQR-EXAMPLE"
}

补量进度 refill_status

返回 Pending、Completed、Rejected 或 Pending review。refills 可批量传1–100个补量编号。

参数类型说明
key字符串必填。你的 AQNAB API Key。
action字符串必填。固定为 refill_status。
refill字符串补量申请返回的编号;批量使用 refills。
请求体(JSON)
{
  "key": "YOUR_KEY",
  "action": "refill_status",
  "refill": "AQR-EXAMPLE"
}
成功响应示例
{
  "status": "Pending"
}

申请取消 cancel

只支持 cancel=true 的非终态订单。返回1表示申请已排队,不代表已取消或已退款。请继续查订单状态。

参数类型说明
key字符串必填。你的 AQNAB API Key。
action字符串必填。固定为 cancel。
orders字符串1–100个订单号,以逗号分隔。
请求体(JSON)
{
  "key": "YOUR_KEY",
  "action": "cancel",
  "orders": "API-EXAMPLE-4ABC"
}
成功响应示例
[
  {
    "order": "API-EXAMPLE-4ABC",
    "cancel": 1
  }
]

服务列表 services

返回当前账户可用的销售目录。使用 service 字符串下单;rate 为每 1,000 单位的美元售价。required 出现时,请按该列表传入订单参数。refill / cancel 标识对应商品是否支持补量和取消申请。

参数类型说明
key字符串必填。你的 AQNAB API Key。
action字符串必填。固定为 services。
请求体(JSON)
{
  "key": "YOUR_KEY",
  "action": "services"
}
成功响应示例
[
  {
    "service": "AQ1-123",
    "name": "TikTok 粉丝",
    "type": "Default",
    "category": "TikTok - 粉丝",
    "rate": "0.900",
    "min": 50,
    "max": 10000,
    "refill": false,
    "cancel": false
  },
  {
    "service": "AQ2-456",
    "name": "TikTok 自定义评论",
    "type": "Custom Comments",
    "category": "TikTok - 评论",
    "rate": "8.00",
    "min": 1,
    "max": 100,
    "refill": false,
    "cancel": false,
    "required": [
      "link",
      "comments"
    ]
  }
]

查询余额 balance

返回当前 API Key 所属账户的可用余额。余额是带 4 位小数的字符串。

参数类型说明
key字符串必填。你的 AQNAB API Key。
action字符串必填。固定为 balance。
请求体(JSON)
{
  "key": "YOUR_KEY",
  "action": "balance"
}
成功响应示例
{
  "balance": "12.5000",
  "currency": "USD"
}

创建订单 add

创建真实订单并扣除余额。总金额 = 数量 ÷ 1,000 × 当前每千售价,保留四位小数。收到订单号后请保存,用于后续查询。请求超时时先在控制台核对订单,避免重复提交。

参数类型说明
key字符串必填。你的 AQNAB API Key。
action字符串必填。固定为 add。
service字符串必填。使用 services 返回的服务编号,例如 AQ1-123。
link字符串必填。公开可访问的 http 或 https 目标链接。
quantity整数普通服务必填,须在 min 和 max 之间。自定义评论按有效行数计算。
comments字符串自定义评论必填,每行一条,合计最多 20,000 字符;空行不计入数量。
keywords字符串要求自定义关键词的服务必填,最多 2,000 字符;其他服务不需要。
请求体(JSON)
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ1-123",
  "link": "https://www.tiktok.com/@example",
  "quantity": 1000
}
成功响应示例
{
  "order": "API-EXAMPLE-4ABC"
}
自定义评论和关键词的请求示例
自定义评论
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ2-456",
  "link": "https://www.tiktok.com/@example/video/123",
  "comments": "第一条评论\n第二条评论"
}
自定义关键词
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ3-789",
  "link": "https://example.com/",
  "quantity": 1000,
  "keywords": "品牌名, 产品名"
}

查询订单状态 status

只能查询当前账户的订单。传 orders 可批量查询最多100个订单(逗号分隔),批量返回按订单号索引的结果。状态包括 Pending、In progress、Completed、Partial、Canceled。start_count 和 remains 来自上游状态同步;尚未返回时为 null。上游状态不等于实际交付的独立证明。

参数类型说明
key字符串必填。你的 AQNAB API Key。
action字符串必填。固定为 status。
order字符串必填。创建订单时返回的 order 字段。
请求体(JSON)
{
  "key": "YOUR_KEY",
  "action": "status",
  "order": "API-EXAMPLE-4ABC"
}
成功响应示例
{
  "charge": "0.9000",
  "start_count": "0",
  "status": "In progress",
  "remains": "1000",
  "currency": "USD"
}

错误处理

HTTP 状态说明
400参数无效、服务不可用或余额不足。
401密钥无效或已撤销。
404找不到当前账户的订单。
500 / 502服务暂不可用。下单请求失败时,请先核对订单与余额。
错误响应示例
{
  "error": "Insufficient funds"
}
cURL 表单示例
curl -X POST https://aqnab.com/api/v2 \
  --data-urlencode "key=YOUR_KEY" \
  --data-urlencode "action=services"

登录后管理下单密钥。发布密钥由站长在 SEO 优化栏目独立生成并安全交接。

常见问题

API 可以完成哪些操作?

当前 /api/v2 支持 services、balance、add、status。服务同步用于读取当前零售价与范围,add 创建真实付费订单,status 查询上游同步后的进度。

发生超时可以马上切换服务吗?

不能。超时可能已被接单,必须先查询原订单并人工核对,再决定是否创建新订单。当前系统不会在不确定的提交结果下自动换线路重复购买。

如何获取密钥?

登录后在 API 接入中心按账户条件生成下单密钥。博客发布使用独立的发布密钥,可限定到指定分站,不能用来扣费下单。

代理可以直接发布博客吗?

可以用发布 API 创建草稿,确认预览后更新为 published;支持列表、修改、删除和图片上传。完整字段与频率限制见接口文档。

为什么服务 ID 不能随意替换?

每个服务 ID 对应具体服务与线路,价格、目标链接、范围和售后都可能不同。先同步目录,按返回的 ID 和链接格式提交,不要猜测编号。

服务目录 · API 详细指南 · 白标分站