REST API · 版本 1

API 参考

自动处理订单、充值和状态查询,只需直接调用 Best SMM Panel | Real Services - SureSMM 即可。每个请求都只是一次简单的 POST 并携带您的 API 密钥 — 响应内容为简洁的 JSON。

POST https://suresmm.com/api/v1
JSON 响应 密钥认证 120 请求/分钟
快速开始

身份验证

每次调用都需要通过您的专属 API 密钥进行身份验证。您可以在控制面板的“账户 → API”中获取密钥,然后将其作为 key 参数,随每个请求一起发送。

参数 类型 描述 必填
key string 您的专属 API 密钥 必填
action string 接口操作 — 例如 services、add、status、refill、balance 必填
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
GET /services

服务列表

返回完整的服务目录,包含实时价格、限额以及补单/分批发送支持信息。

参数 类型 描述
key string 您的 API 密钥
action string "services"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=services"
200 响应
[
  {
    "service": 1,
    "name": "YouTube Livestream Viewers",
    "rate": "0.33000000",
    "min": 1000,
    "max": 200000,
    "category": "Live Stream",
    "refill": true,
    "dripfeed": true
  }
]
POST /add

添加订单

为某项服务下一个新订单。可选的分批发送字段可让您将发送过程拆分为多次执行。

参数 类型 描述 必填
key string 您的 API 密钥 必填
action string "add" 必填
service integer 服务 ID 必填
link string 目标页面链接 必填
quantity integer 需交付的数量 必填
runs integer 发送次数 可选
interval integer 间隔时间(分钟) 可选
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://example.com/post" \
  -d "quantity=1000"
200 响应
{
  "order": 1242
}
POST /status

订单状态

查询任意订单的进度 — 状态、起始数量与剩余数量。

参数 类型 描述
key string 您的 API 密钥
action string "status"
order integer 订单号
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=1242"
200 响应
{
  "status": "Pending",
  "start_count": "1000",
  "remains": "500",
  "currency": "USD"
}
可用状态
待处理 处理中 已完成 部分完成 已取消 已退款
POST /refill

补单

为符合条件的订单申请补单,然后轮询补单状态直至完成。

创建补单

参数 类型 描述
key string 您的 API 密钥
action string "refill"
order integer 订单号
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill" \
  -d "order=1242"
200 响应
{
  "success": "Your order will be refilled asap. Thank you for your patience",
  "refill": 12345
}

补单状态

参数 类型 描述
key string 您的 API 密钥
action string "refill_status"
refill integer 补单 ID
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill_status" \
  -d "refill=12345"
200 响应
{
  "status": "Completed"
}
POST /balance

用户余额

获取当前账户余额及其币种。

参数 类型 描述
key string 您的 API 密钥
action string "balance"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
200 响应
{
  "balance": "100.84292",
  "currency": "USD"
}
参考

错误响应

当请求无效时,API 会返回一个包含 error 字段信息的 JSON 对象。常见错误如下所示。

action 字段为必填项
api key 字段为必填项
无效的 API 密钥
无效的 action
无效的服务 ID
链接字段为必填项
数量字段为必填项
请遵守数量限制
余额不足
订单字段为必填项
无效的订单 ID
该订单不符合补单条件
错误结构
{
  "error": "Invalid api key"
}
与我们在线聊天