跳至內容

SMM 面板 API:服務、訂單、狀態及結餘

SMMHO API 採用 SMM 面板通用的 API v2 格式。向同一地址發送 POST 請求,以 action 值指定要執行的工作,回覆為 JSON。

API 基本資料

端點
POST https://smmho.com/api/v2
請求格式
application/x-www-form-urlencoded 或 application/json
驗證
在 key 欄位填入你的 API 金鑰。登入後可在帳戶頁建立
回覆
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
該服務不設補量,或補量期已結束