Chuyển đến nội dung

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ả
keyKhóa API của bạn
actionservices

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ả
keyKhóa API của bạn
actionadd
serviceID dịch vụ
linkLink video, Short, buổi phát trực tiếp hoặc kênh
quantitySố lượng (không áp dụng cho Custom Comments hoặc Package)
commentsChỉ 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ả
keyKhóa API của bạn
actionstatus
orderID đơ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ả
keyKhóa API của bạn
actionstatus
ordersCá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ả
keyKhóa API của bạn
actionrefill
orderID đơ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ả
keyKhóa API của bạn
actionrefill_status
refillID 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ả
keyKhóa API của bạn
actionbalance

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ư
CanceledKhô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 keyKhóa bị thiếu, sai hoặc đã được thay thế
Incorrect service IDKhông có dịch vụ đang hoạt động với ID này
Incorrect linkLink trống hoặc không phải địa chỉ web
Quantity out of rangeThấ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 balanceHãy nạp tiền trước
Too many requestsHơn 300 yêu cầu trong một phút