SMM面板 API 文件

甚麼是 SMM面板 API？

SMM面板 API 讓程式毋須經過網站，即可取得服務列表、下單，以及查詢訂單狀態和餘額。4SNS PLUS 支援眾多面板和 Bot 採用的標準 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 key？

首次增值存入餘額後，即可在控制台的 API key 選單建立 API key。key 只會在建立時顯示一次，請妥善保存。建立新 key 後，舊 key 會即時停用。

key 與您的帳戶 token 分開。請只把 API key 放在 Bot 或伺服器上，切勿放入帳戶 token。如懷疑 key 已外洩，只需在 API key 畫面建立新的即可。

服務列表（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 就是您的訂單 ID。

回應例子

{
  "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 張訂單，訂單 ID 以逗號分隔。不存在或不屬於您帳戶的 ID，會在相應位置回傳 error。

回應例子

{
  "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 回應中附 error 欄位的 JSON 回傳。程式中請先檢查 error 欄位。

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

如何把 SMM面板 API 接駁到 Telegram Bot？