SMM 面板 API v2 參考文件
1PANEL PLUS 使用標準 SMM 面板 API v2。以你的 API 金鑰及 action 發送 POST 請求;所有回應均為 JSON。價格及餘額與網站相同。
基本資料
- 端點
- https://1panelplus.com/api/v2
- 方法
- POST
- 參數
- 表單欄位或 JSON 內容
- 你的 API 金鑰
- 從控制台的 API 金鑰頁面取得
- 請求限制
- 每個金鑰每分鐘 300 次請求
請求例子
curl -X POST https://1panelplus.com/api/v2 \ -d key=YOUR_API_KEY \ -d action=balance
服務清單
所有有效服務。rate 為每 1,000 的美元價格;type 為 Package 時則為每個套餐的價格。
| 參數 | 說明 |
|---|---|
| key | 你的 API 金鑰 |
| action | services |
回應例子
[
{
"service": 1204,
"name": "YouTube Views - 30 Days Refill",
"type": "Default",
"category": "YouTube - Views (30 Days Refill)",
"rate": "1.5600",
"min": "100",
"max": "1000000",
"refill": true,
"cancel": false
}
]新增訂單
下單並從你的餘額扣款。Custom Comments 請發送 comments(每行一則)代替 quantity。
| 參數 | 說明 |
|---|---|
| key | 你的 API 金鑰 |
| action | add |
| service | 服務 ID |
| link | 影片、Short、直播或頻道的連結 |
| quantity | 數量(不適用於 Custom Comments 或 Package) |
| comments | 只限 Custom Comments:每行一則留言 |
回應例子
{
"order": 23501
}訂單狀態
單一訂單的狀態。charge 為你所付金額(美元)。
| 參數 | 說明 |
|---|---|
| key | 你的 API 金鑰 |
| action | status |
| order | 訂單 ID |
回應例子
{
"charge": "1.560000",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}多個訂單狀態
最多 100 張訂單的狀態,以逗號分隔。
| 參數 | 說明 |
|---|---|
| key | 你的 API 金鑰 |
| action | status |
| orders | 訂單 ID,例如 1,10,100 |
回應例子
{
"1": { "charge": "0.270000", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
"10": { "error": "Incorrect order ID" }
}補量
為補量服務的已完成訂單申請補量。
| 參數 | 說明 |
|---|---|
| key | 你的 API 金鑰 |
| action | refill |
| order | 訂單 ID |
回應例子
{
"refill": 412
}補量狀態
補量申請的狀態。
| 參數 | 說明 |
|---|---|
| key | 你的 API 金鑰 |
| action | refill_status |
| refill | 補量 ID |
回應例子
{
"status": "Completed"
}餘額
你的美元餘額。
| 參數 | 說明 |
|---|---|
| key | 你的 API 金鑰 |
| action | balance |
回應例子
{
"balance": "100.840000",
"currency": "USD"
}訂單狀態
| 等候中 | 已收到,等待開始 |
| 進行中 | 送達中 |
| 已完成 | 已全數送達 |
| 部分完成 | 已送達部分;其餘已退回你的餘額 |
| 已取消 | 未有送達;已全數退款 |
錯誤
錯誤會以附有 error 訊息的 JSON 傳回,例如:
{
"error": "Not enough funds on balance"
}| API 金鑰無效 | 金鑰缺少、錯誤或已被更換 |
| 服務 ID 不正確 | 沒有此 ID 的有效服務 |
| 連結不正確 | 連結為空白或不是網址 |
| 數量超出範圍 | 低於服務的最少數量或高於最多數量 |
| 餘額不足 | 請先增值 |
| 請求過多 | 一分鐘內超過 300 次請求 |