SMM Panel API v2

Tổng quan

API SMM v2 sử dụng kiến trúc action-based routing - tất cả request gửi đến cùng 1 endpoint /api/v2, phân biệt chức năng qua tham số action.

Các action hỗ trợ:

• services - Lấy danh sách dịch vụ có sẵn
• add - Tạo đơn hàng mới
• status - Kiểm tra trạng thái đơn hàng (đơn lẻ hoặc nhiều đơn)
• balance - Kiểm tra số dư tài khoản

Định dạng request hỗ trợ:

• application/json - JSON (khuyến nghị)
• application/x-www-form-urlencoded - Form URL-encoded
• multipart/form-data - Multipart form data

Xác thực

Mọi request đều cần có API Key trong body JSON với tên trường key.

Cách lấy API Key:

1. Đăng nhập vào dashboard
2. Vào mục Tài khoản & Nạp Xu
3. Tìm mục Token API và copy giá trị

Ví dụ request có API Key:

{
  "key": "abc123def456...",
  "action": "balance"
}

Base URL

Thay _domain_ bằng domain thực tế của hệ thống (ví dụ: https://yoursite.com).

Request Method:

Tất cả request đều dùng phương thức POST.

Content-Type hỗ trợ:

API hỗ trợ 3 định dạng body - bạn có thể chọn 1 trong các loại sau:

Ví dụ Header:

// Sử dụng JSON (khuyến nghị)
Content-Type: application/json

// Hoặc sử dụng form-data
Content-Type: application/x-www-form-urlencoded

// Hoặc multipart
Content-Type: multipart/form-data

Action: services

Lấy danh sách tất cả các dịch vụ đang hoạt động (comment, like, follow, ...) với thông tin giá, min/max, category.

Request

Body JSON:

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Response thành công

Trả về mảng JSON chứa danh sách dịch vụ:

[
  {
    "service": 1001,
    "name": "Facebook Comment Ultra",
    "type": "Custom Comments",
    "category": "Facebook - Comment v1",
    "rate": "200",
    "min": "5",
    "max": "2000",
    "refill": false,
    "dripfeed": false
  },
  {
    "service": 2001,
    "name": "Facebook Like Normal",
    "type": "Default",
    "category": "Facebook - Like",
    "rate": "50",
    "min": "10",
    "max": "5000",
    "refill": false,
    "dripfeed": false
  }
  ...
]

Giải thích các trường:

Ví dụ cURL

Cách 1: Sử dụng JSON

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "services"
}'

Cách 2: Sử dụng form-data

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'key=YOUR_API_KEY&action=services'

Action: add

Tạo đơn hàng mới (order) cho một dịch vụ cụ thể.

Request

Body JSON (Comment):

{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 1001,
  "link": "https://www.facebook.com/your-page/posts/1234567890",
  "quantity": 100,
  "comments": "Bình luận 1\nBình luận 2\nBình luận 3"
}

Body JSON (Reaction):

{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 12000,
  "link": "https://www.facebook.com/your-page/posts/1234567890",
  "quantity": 50,
  "reaction": "LOVE"
}

Response thành công

{
  "order": 12345
}

Ví dụ cURL

1. Đặt đơn Comment (JSON):

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 1001,
  "link": "https://www.facebook.com/your-page/posts/1234567890",
  "quantity": 100,
  "comments": "Hay quá!\nRất bổ ích\nCảm ơn admin"
}'

1b. Đặt đơn Comment (form-data):

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'key=YOUR_API_KEY' \
--data 'action=add' \
--data 'service=1001' \
--data 'link=https://www.facebook.com/your-page/posts/1234567890' \
--data 'quantity=100' \
--data-urlencode 'comments=Hay quá!
Rất bổ ích
Cảm ơn admin'

2. Đặt đơn Like (JSON):

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 2001,
  "link": "https://www.facebook.com/your-page/posts/1234567890",
  "quantity": 500
}'

2b. Đặt đơn Like (form-data):

curl --location '_domain_/api/v2' \
--data 'key=YOUR_API_KEY&action=add&service=2001&link=https://www.facebook.com/your-page/posts/1234567890&quantity=500'

3. Đặt đơn Follow (JSON):

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 3001,
  "link": "https://www.facebook.com/profile.php?id=100012345678",
  "quantity": 200
}'

3b. Đặt đơn Follow (form-data):

curl --location '_domain_/api/v2' \
--data 'key=YOUR_API_KEY&action=add&service=3001&link=https://www.facebook.com/profile.php?id=100012345678&quantity=200'

4. Đặt đơn Reaction (JSON):

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "add",
  "service": 12000,
  "link": "https://www.facebook.com/your-page/posts/1234567890",
  "quantity": 50,
  "reaction": "LOVE"
}'

4b. Đặt đơn Reaction (form-data):

curl --location '_domain_/api/v2' \
--data 'key=YOUR_API_KEY&action=add&service=12000&link=https://www.facebook.com/your-page/posts/1234567890&quantity=50&reaction=LOVE'

Action: status

Kiểm tra trạng thái đơn hàng (đơn lẻ hoặc nhiều đơn cùng lúc).

1. Kiểm tra đơn lẻ

Body JSON:

{
  "key": "YOUR_API_KEY",
  "action": "status",
  "order": 12345
}

Response thành công:

{
  "charge": "10000",
  "start_count": "150",
  "status": "In progress",
  "remains": "50"
}

2. Kiểm tra nhiều đơn

Body JSON:

{
  "key": "YOUR_API_KEY",
  "action": "status",
  "orders": "12345,12346,12347"
}

Response thành công:

{
  "12345": {
    "charge": "10000",
    "start_count": "150",
    "status": "Completed",
    "remains": "0"
  },
  "12346": {
    "charge": "5000",
    "start_count": "80",
    "status": "In progress",
    "remains": "20"
  },
  "12347": {
    "error": "Incorrect order ID"
  }
}

Ví dụ cURL

Đơn lẻ (JSON):

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "status",
  "order": 12345
}'

Đơn lẻ (form-data):

curl --location '_domain_/api/v2' \
--data 'key=YOUR_API_KEY&action=status&order=12345'

Nhiều đơn (JSON):

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "status",
  "orders": "12345,12346,12347"
}'

Nhiều đơn (form-data):

curl --location '_domain_/api/v2' \
--data 'key=YOUR_API_KEY&action=status&orders=12345,12346,12347'

Action: balance

Kiểm tra số dư hiện tại của tài khoản.

Request

Body JSON:

{
  "key": "YOUR_API_KEY",
  "action": "balance"
}

Response thành công

{
  "balance": "51601277",
  "currency": "xu"
}

Ví dụ cURL

Sử dụng JSON:

curl --location '_domain_/api/v2' \
--header 'Content-Type: application/json' \
--data '{
  "key": "YOUR_API_KEY",
  "action": "balance"
}'

Sử dụng form-data:

curl --location '_domain_/api/v2' \
--data 'key=YOUR_API_KEY&action=balance'

Mã lỗi

Khi có lỗi, API trả về JSON với trường error:

{
  "error": "Mô tả lỗi"
}

Các lỗi thường gặp

Trạng thái Job

Khi kiểm tra status đơn hàng, trường status có thể có các giá trị sau: