SMM面板 API 文档

什么是 SMM面板 API？

SMM面板 API 让程序无需打开网站，就能获取服务列表、下单并查询订单状态和余额。4SNS PLUS 支持众多面板和机器人通用的标准 SMM面板 API v2 格式，已经对接其他面板的代码，只需更换 URL 和 key 即可直接使用。

API 的价格和余额与网站完全相同。services 响应中的 rate 等于价格表里的每 1,000 价格（美元），用 add 提交的订单与网页订单一样从余额扣款，也会出现在后台的订单记录中。取消或部分完成订单退回的金额同样回到这个余额。

基本信息

请求示例

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

如何获取 API 密钥？

首次充值到账后，即可在后台的 API 密钥菜单中创建 API 密钥。密钥只在创建时显示一次，请妥善保存。创建新密钥后，旧密钥会立即失效。

API 密钥与账户令牌是分开的。机器人或服务器中只放 API 密钥，切勿放入账户令牌。如果担心密钥泄露，只需在 API 密钥页面重新创建一个。

服务列表（services）

返回所有可订购的服务。rate 为每 1,000 价格（USD），type 为 Package 时则是一个套餐的价格。type 为 Custom Comments 时，提交的是评论列表而不是数量。category 为平台名加分组名。

响应示例

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

提交订单（add）

提交订单并从余额扣款。金额为每 1,000 价格乘以数量；Package 按套餐价格计算，Custom Comments 以评论行数作为数量。首次充值已到账的账户才能下单。响应中的 order 即您的订单编号。

响应示例

{
  "order": 31877
}

订单状态（status）

查询单个订单的状态。charge 为扣除退款后的实际支付金额（USD，6 位小数），start_count 为订单开始时的数量，remains 为尚未交付的数量。

响应示例

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

批量订单状态（status, orders）

一次最多查询 100 个订单，订单编号用逗号分隔。不存在或不属于您账户的编号，会在对应位置返回错误。

响应示例

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

申请补量（refill）

适用于有补量期、并以 Completed 或 Partial 结束的服务订单，需在订单结束后的补量期内申请。每个订单同时只能有一个未结申请，两次申请需间隔 24 小时。

响应示例

{
  "refill": 512
}

补量状态（refill_status）

查询单个补量申请的状态。

响应示例

{
  "status": "Completed"
}

余额（balance）

您的余额（USD，6 位小数）。

响应示例

{
  "balance": "84.120000",
  "currency": "USD"
}

订单状态值

补量状态值

错误信息

错误以 HTTP 200 响应返回，JSON 中带有 error 字段。请在代码中先检查 error 字段。

{
  "error": "Not enough funds on balance"
}

如何把 SMM面板 API 接入 电报机器人？