鉴权
所有请求使用 POST(application/x-www-form-urlencoded),携带参数 key。API Key 在 个人中心 → API 设置 生成,每个账号 1 个,可随时重置或停用。
限流 60 次/分钟;连续 20 次错误 Key 将封禁来源 IP 10 分钟。
动作一览
| action | 参数 | 功能 |
|---|---|---|
services | — | 获取全部服务与价格 |
add | service link quantity | 下单(扣 API Key 所属账号余额) |
status | order | 查询订单状态 |
balance | — | 查询账户余额 |
refill | order | 对已完成订单发起补货 |
services — 服务列表
请求:POST /api/v2 key=YOUR_KEY&action=services
响应:
[
{
"service": 4882,
"name": "Facebook 直播 Viewers [ Max 20K ] | 300 Minutes",
"category": "Facebook 直播 播放量",
"rate": "7.20",
"min": 50,
"max": 20000,
"refill": false,
"cancel": true
}
]add — 下单
请求:POST /api/v2 key=YOUR_KEY&action=add&service=4882&link=https://facebook.com/xxx&quantity=50
响应:
{ "order": 1850 }status — 查询订单
请求:POST /api/v2 key=YOUR_KEY&action=status&order=1850
响应:
{
"charge": "5",
"start_count": "1024",
"status": "Completed",
"remains": "0",
"currency": "CNY"
}balance — 查询余额
请求:POST /api/v2 key=YOUR_KEY&action=balance
响应:
{ "balance": "21.00", "currency": "CNY" }refill — 补货
请求:POST /api/v2 key=YOUR_KEY&action=refill&order=1850
响应:
{ "refill": 551 }调用示例 (cURL)
请求:
响应:
curl -X POST https://miaohub.cc/api/v2 \
-d "key=YOUR_KEY" \
-d "action=add" \
-d "service=4882" \
-d "link=https://facebook.com/xxx" \
-d "quantity=50"错误码
| error | 含义 |
|---|---|
Incorrect API key | Key 无效或已停用 |
Rate limit exceeded (60 req/min) | 超过限流 |
Incorrect service ID | 服务不存在或已下架 |
Quantity out of range | 数量超出服务上下限 |
Incorrect link | 链接格式错误(需 http/https) |
Active order already exists | 60秒内重复下单 |
Insufficient balance | 余额不足 |
Account suspended | 账号被封禁 |
Order not eligible for refill | 订单不可补货(未完成或已有补货中) |
Refill already requested | 已有进行中的补货单 |
说明
- 价格与面板展示完全一致(人民币/千),下单从 Key 所属账号的余额扣费(1 积分 = ¥1)
- API 下单同样计入消费等级,享受对应的订单返点
- 订单状态值:
Pending/Processing/In progress/Completed/Partial/Canceled/Failed - 60 秒内相同 服务+链接+数量 的重复下单会被拒绝(幂等保护)
