AQNAB API 接入指南
经销商可用统一接口同步目录、创建订单和跟踪进度。公开文档不包含密钥,下单使用账户余额;请在服务端保存密钥。
服务同步与下单
- 调用 services 获取服务 ID、每千价、最小和最大数量、补量标签与链接格式。
- 根据服务类型填写公开主页或指定内容链接,调用 add 提交。下单会再次校验数量、链接与余额。
- 保存返回的 AQNAB 订单号,调用 status 查看真实上游同步后的状态、起始数量及剩余数量。
- 超时或结果不确定时先查询并人工核对,不直接换线路重复下单。只有确认未接单后,才能选择其他服务重新提交。
最小调用示例
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 详细指南 · 白标分站