AQNAB 域名验收 API 接入

本站密钥仅使用你在本站的采购余额和报价,不使用主站或其他站余额。先充值后下单,各级余额不足时整笔不扣款。

AQNAB API V2

开发者接口文档

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

HTTP 方法
POST
接口地址
https://aqnab.com/site/aqnab-domain-check/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/site/aqnab-domain-check/api/v2 \
  --data-urlencode "key=YOUR_KEY" \
  --data-urlencode "action=services"
登录管理本站 API