跳至主要內容

SMM 面板 API:服務、訂單、狀態與餘額

SMMHO API 採用 SMM 面板常見的 API v2 格式。向同一個網址送出 POST 請求,以 action 值指定要做的事,即可取得 JSON 回應。

API 基本資訊

端點
POST https://smmho.com/api/v2
請求格式
application/x-www-form-urlencoded 或 application/json
驗證
將 API 金鑰填入 key 欄位。登入後可在帳號頁面建立
回應
JSON。請求失敗時,原因會放在 error 欄位
頻率限制
每個金鑰每分鐘 300 次請求
建立 API 金鑰登入後,可在帳號頁面建立 API 金鑰。
curl https://smmho.com/api/v2 \  -d "key=YOUR_API_KEY" \  -d "action=add" -d "service=9340" \  -d "link=https://instagram.com/me" \  -d "quantity=1000"
// { "order": "TT5M-CA9L" }

SMM 面板 API 動作

action=services服務清單

回傳所有服務的編號、名稱、類別、每 1,000 價格、最小與最大數量,以及是否有補量。

參數
名稱說明
keyAPI 金鑰
actionservices

回應範例

[
  {
    "service": 9340,
    "name": "Instagram Followers, 30-day refill",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "2.2470",
    "min": 50,
    "max": 75000,
    "refill": true,
    "cancel": true
  }
]

action=add新訂單

以服務編號、連結和數量下單。費用從餘額扣除,並回傳訂單編號。

參數
名稱說明
keyAPI 金鑰
actionadd
service服務編號
link帳號或貼文連結
quantity數量(須在服務的最小與最大範圍內)

回應範例

{
  "order": "TT5M-CA9L"
}

action=status訂單狀態

回傳單一訂單編號(order)或最多 100 個以逗號分隔的編號(orders)的費用、起始數量、狀態和剩餘數量。

參數
名稱說明
keyAPI 金鑰
actionstatus
order單一訂單編號
orders多個訂單編號(以逗號分隔,最多 100 個)

回應範例

{
  "charge": "2.2470",
  "start_count": 0,
  "status": "Pending",
  "remains": 1000,
  "currency": "USD"
}

action=balance餘額

回傳目前的餘額與幣別。

參數
名稱說明
keyAPI 金鑰
actionbalance

回應範例

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

action=cancel取消訂單

取消待處理的訂單,費用退回餘額。

參數
名稱說明
keyAPI 金鑰
actioncancel
orders訂單編號(以逗號分隔,最多 100 個)

回應範例

[
  {
    "order": "TT5M-CA9L",
    "cancel": 1
  }
]

action=refill申請補量

對仍在補量期間內的已完成或部分完成訂單申請補量,並回傳申請編號。

參數
名稱說明
keyAPI 金鑰
actionrefill
order訂單編號

回應範例

{
  "refill": "RK7QM-2XWD"
}

訂單狀態值

待處理
尚未開始,可以取消
進行中
進量中
已完成
已全部完成
部分完成
部分完成。未完成的部分退回餘額
已取消
已取消。費用退回餘額

API 錯誤

Invalid API key
金鑰錯誤,或已被新金鑰取代
Invalid service
沒有此編號的服務
Invalid link
不是以 https:// 開頭的公開網址
Quantity out of range
數量超出服務的最小與最大範圍
Not enough funds on balance
餘額不足
Too many requests
已達頻率限制。請稍後再送出
Refill already requested
此訂單已有進行中的補量申請
Refill is not available for this order
該服務沒有補量,或補量期間已結束