SMM面板 API 文件

什麼是 SMM面板 API？

SMM面板 API 讓程式不必透過網站，就能取得服務清單、下單，並查詢訂單狀態與餘額。4SNS PLUS 支援許多面板與機器人共用的標準 SMM面板 API v2 格式，所以您已經串接其他面板的程式碼，只要換掉 URL 和金鑰就能直接使用。

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 就是您的訂單 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）

以逗號串接訂單 ID，一次最多查詢 100 筆。不存在或不屬於您帳號的 ID，會在該位置回傳錯誤。

回應範例

{
  "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 串接到 Telegram 機器人？