SMM panel API: tài liệu hướng dẫn

SMM panel API là gì?

SMM panel API cho phép chương trình lấy danh sách dịch vụ, đặt hàng, kiểm tra trạng thái đơn và số dư mà không cần vào website. 4SNS PLUS hỗ trợ định dạng SMM panel API v2 chuẩn mà nhiều panel và bot đang dùng, nên code bạn đã kết nối với panel khác sẽ chạy ngay khi đổi URL và key.

Giá và số dư trên API giống hệt trên website. Giá rate trong response services bằng giá mỗi 1,000 (đô la Mỹ) trong bảng giá, và đơn đặt bằng add được trừ vào số dư y như đơn đặt trên web, đồng thời hiện trong lịch sử đơn hàng ở trang quản lý. Số tiền hoàn từ đơn bị hủy hoặc đơn giao một phần sẽ trả về cùng số dư đó.

Thông tin cơ bản

Ví dụ request

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

Làm sao để lấy API key?

Khi lần nạp tiền đầu tiên được cộng vào số dư, bạn có thể tạo API key trong mục API key ở trang quản lý. Key chỉ hiện một lần lúc tạo, vì vậy hãy lưu ở nơi an toàn. Khi tạo key mới, key cũ sẽ ngừng hoạt động ngay.

Key tách biệt với token tài khoản. Chỉ đưa API key vào bot hoặc server, không bao giờ đưa token tài khoản. Nếu nghĩ key đã bị lộ, bạn chỉ cần tạo key mới ở màn hình API key.

Danh sách dịch vụ (services)

Trả về mọi dịch vụ bạn có thể đặt. rate là giá mỗi 1,000 (USD), và khi type là Package thì đó là giá của một gói. Khi type là Custom Comments, bạn gửi danh sách bình luận thay cho số lượng. category là tên nền tảng kèm tên nhóm.

Ví dụ response

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

Tạo đơn hàng (add)

Tạo đơn hàng và trừ tiền vào số dư. Số tiền bằng giá mỗi 1,000 nhân với số lượng; với Package là giá gói, còn với Custom Comments thì số dòng bình luận chính là số lượng. Tài khoản đã được cộng lần nạp đầu tiên mới đặt hàng được. order trong response là mã đơn hàng của bạn.

Ví dụ response

{
  "order": 31877
}

Trạng thái đơn hàng (status)

Trạng thái của một đơn hàng. charge là số tiền thực trả sau khi hoàn (USD, 6 chữ số thập phân), start_count là số đếm lúc đơn bắt đầu, còn remains là số lượng chưa giao.

Ví dụ response

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Trạng thái nhiều đơn hàng (status, orders)

Kiểm tra tối đa 100 đơn một lần, các mã đơn nối bằng dấu phẩy. Mã không tồn tại hoặc không thuộc tài khoản của bạn sẽ nhận error tại vị trí đó.

Ví dụ response

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Yêu cầu refill (refill)

Với đơn của dịch vụ có thời hạn refill đã kết thúc ở trạng thái Completed hoặc Partial, hãy gửi yêu cầu trong thời hạn refill tính từ lúc đơn kết thúc. Mỗi đơn có thể có một yêu cầu đang mở, cách nhau 24 giờ giữa các lần yêu cầu.

Ví dụ response

{
  "refill": 512
}

Trạng thái refill (refill_status)

Trạng thái của một yêu cầu refill.

Ví dụ response

{
  "status": "Completed"
}

Số dư (balance)

Số dư của bạn (USD, 6 chữ số thập phân).

Ví dụ response

{
  "balance": "84.120000",
  "currency": "USD"
}

Giá trị trạng thái đơn hàng

Giá trị trạng thái refill

Thông báo lỗi

Lỗi trả về dạng JSON có trường error trong response HTTP 200. Trong code, hãy kiểm tra trường error trước tiên.

{
  "error": "Not enough funds on balance"
}

Cách kết nối SMM panel API với bot Telegram?