เอกสารอ้างอิง SMM Panel API v2
1PANEL PLUS ใช้ SMM Panel API v2 มาตรฐาน ส่งคำขอ POST พร้อมคีย์ API และ action ทุกการตอบกลับเป็น JSON ราคาและยอดเงินเหมือนกับบนเว็บไซต์
พื้นฐาน
- Endpoint
- https://1panelplus.com/api/v2
- เมธอด
- POST
- พารามิเตอร์
- ฟิลด์ฟอร์มหรือ JSON body
- คีย์ API ของคุณ
- จากหน้าคีย์ API ในแดชบอร์ดของคุณ
- ขีดจำกัดอัตรา
- 300 คำขอต่อนาทีต่อคีย์
ตัวอย่างคำขอ
curl -X POST https://1panelplus.com/api/v2 \ -d key=YOUR_API_KEY \ -d action=balance
รายการบริการ
บริการที่เปิดใช้งานทั้งหมด rate คือราคาต่อ 1,000 เป็น USD หรือราคาของหนึ่งแพ็กเกจเมื่อ 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 คือจำนวนที่คุณจ่าย เป็น USD
| พารามิเตอร์ | คำอธิบาย |
|---|---|
| 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"
}ยอดเงิน
ยอดเงินของคุณเป็น USD
| พารามิเตอร์ | คำอธิบาย |
|---|---|
| key | คีย์ API ของคุณ |
| action | balance |
ตัวอย่างการตอบกลับ
{
"balance": "100.840000",
"currency": "USD"
}สถานะคำสั่งซื้อ
| รอดำเนินการ | ได้รับแล้ว รอเริ่ม |
| กำลังดำเนินการ | กำลังส่งมอบ |
| เสร็จสมบูรณ์ | ส่งมอบครบแล้ว |
| บางส่วน | ส่งมอบบางส่วน ส่วนที่เหลือคืนเข้ายอดเงินของคุณ |
| ยกเลิกแล้ว | ไม่ได้ส่งมอบ คืนเงินเต็มจำนวน |
ข้อผิดพลาด
ข้อผิดพลาดจะส่งกลับเป็น JSON พร้อมข้อความ error เช่น:
{
"error": "Not enough funds on balance"
}| Invalid API key | ไม่มีคีย์ คีย์ผิด หรือคีย์ถูกเปลี่ยนแล้ว |
| Incorrect service ID | ไม่มีบริการที่เปิดใช้งานด้วย ID นี้ |
| Incorrect link | ลิงก์ว่างหรือไม่ใช่ที่อยู่เว็บ |
| Quantity out of range | ต่ำกว่าขั้นต่ำหรือสูงกว่าสูงสุดของบริการ |
| Not enough funds on balance | เติมเงินก่อน |
| Too many requests | มากกว่า 300 คำขอในหนึ่งนาที |