Tài liệu API
1PANEL PLUS dùng API v2 chuẩn của SMM panel. Gửi yêu cầu POST kèm khóa API và một action; mọi phản hồi đều là JSON. Giá và số dư giống hệt trên website.
Cơ bản
- Endpoint
- https://1panelplus.com/api/v2
- Phương thức
- POST
- Tham số
- Trường form hoặc body JSON
- Khóa API của bạn
- Lấy từ trang Khóa API trong bảng điều khiển
- Giới hạn tần suất
- 300 yêu cầu mỗi phút cho mỗi khóa
Ví dụ yêu cầu
curl -X POST https://1panelplus.com/api/v2 \ -d key=YOUR_API_KEY \ -d action=balance
Danh sách dịch vụ
Tất cả dịch vụ đang hoạt động kèm giá mỗi 1.000 bằng USD.
| Tham số | Mô tả |
|---|---|
| key | Khóa API của bạn |
| action | services |
Ví dụ phản hồi
[
{
"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
}
]Đặt đơn
Tạo đơn hàng và trừ giá từ số dư của bạn. Với Custom Comments, gửi comments (mỗi dòng một bình luận) thay cho quantity.
| Tham số | Mô tả |
|---|---|
| key | Khóa API của bạn |
| action | add |
| service | ID dịch vụ |
| link | Link video, Short, buổi phát trực tiếp hoặc kênh |
| quantity | Số lượng (không áp dụng cho Custom Comments hoặc Package) |
| comments | Chỉ cho Custom Comments: mỗi dòng một bình luận |
Ví dụ phản hồi
{
"order": 23501
}Trạng thái đơn
Trạng thái của một đơn hàng. charge là số tiền bạn đã trả, tính bằng USD.
| Tham số | Mô tả |
|---|---|
| key | Khóa API của bạn |
| action | status |
| order | ID đơn hàng |
Ví dụ phản hồi
{
"charge": "1.560000",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}Trạng thái nhiều đơn
Trạng thái của tối đa 100 đơn hàng, phân cách bằng dấu phẩy.
| Tham số | Mô tả |
|---|---|
| key | Khóa API của bạn |
| action | status |
| orders | Các ID đơn hàng, ví dụ 1,10,100 |
Ví dụ phản hồi
{
"1": { "charge": "0.270000", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
"10": { "error": "Incorrect order ID" }
}Bù lại (refill)
Yêu cầu bù lại cho đơn đã hoàn thành của dịch vụ có bù lại.
| Tham số | Mô tả |
|---|---|
| key | Khóa API của bạn |
| action | refill |
| order | ID đơn hàng |
Ví dụ phản hồi
{
"refill": 412
}Trạng thái bù lại
Trạng thái của một yêu cầu bù lại.
| Tham số | Mô tả |
|---|---|
| key | Khóa API của bạn |
| action | refill_status |
| refill | ID yêu cầu bù lại |
Ví dụ phản hồi
{
"status": "Completed"
}Số dư
Số dư của bạn bằng USD.
| Tham số | Mô tả |
|---|---|
| key | Khóa API của bạn |
| action | balance |
Ví dụ phản hồi
{
"balance": "100.840000",
"currency": "USD"
}Trạng thái đơn hàng
| Pending | Đã nhận, đang chờ bắt đầu |
| In progress | Đang được giao |
| Completed | Đã giao đầy đủ |
| Partial | Đã giao một phần; phần còn lại được hoàn vào số dư |
| Canceled | Không được giao; hoàn tiền toàn bộ |
Lỗi
Lỗi được trả về dạng JSON kèm thông báo error, ví dụ:
{
"error": "Not enough funds on balance"
}| Invalid API key | Khóa bị thiếu, sai hoặc đã được thay thế |
| Incorrect service ID | Không có dịch vụ đang hoạt động với ID này |
| Incorrect link | Link trống hoặc không phải địa chỉ web |
| Quantity out of range | Thấp hơn mức tối thiểu hoặc cao hơn mức tối đa của dịch vụ |
| Not enough funds on balance | Hãy nạp tiền trước |
| Too many requests | Hơn 300 yêu cầu trong một phút |