Thông báo hệ thống
Tài Liệu SMM API v2 Protocol
Tài Liệu Tích Hợp API Dành Cho Reseller & Lập Trình Viên
Hệ thống hỗ trợ chuẩn giao thức SMM Panel API v2 tương thích 100% với các mã nguồn SMM, Bot Telegram, Cron job tự động hóa và các hệ thống mở rộng.
1. Giao Thức & Cơ Chế Xác Thực
Tất cả các yêu cầu API đều sử dụng phương thức HTTP POST (hoặc RESTful GET/POST tương ứng) gửi tới endpoint duy nhất hoặc REST endpoint. Để xác thực, bạn cần truyền tham số key trong form-data, JSON body hoặc gửi qua Header HTTP:
2. Lấy Danh Sách Dịch Vụ (Action: services)
Trả về toàn bộ danh sách dịch vụ mạng xã hội đang mở bán, bao gồm giá bán (Rate), giới hạn Min/Max, Phân loại và Nền tảng.
| Tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
key |
String | Bắt buộc | Mã API Key cá nhân của bạn |
action |
String | Bắt buộc | Giá trị cố định: services |
[
{
"service": 1,
"name": "Like Bài Viết Facebook Siêu Tốc (Bảo Hành 30 Ngày)",
"type": "Default",
"category": "Facebook Like Post",
"rate": "15.00",
"min": 50,
"max": 50000,
"refill": true,
"cancel": false
},
{
"service": 2,
"name": "Follower TikTok Tài Khoản Thật Việt Nam",
"type": "Default",
"category": "TikTok Followers",
"rate": "45.00",
"min": 100,
"max": 100000,
"refill": true,
"cancel": true
}
]
3. Tạo Đơn Hàng Mới (Action: add)
Khởi tạo đơn hàng tăng tương tác mới. Hệ thống sẽ tự động trừ số dư ví tương ứng và chuyển tới máy chủ xử lý tức thì.
| Tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
key |
String | Bắt buộc | Mã API Key cá nhân của bạn |
action |
String | Bắt buộc | Giá trị cố định: add |
service |
Integer | Bắt buộc | ID của dịch vụ (Lấy từ action services) |
link |
String | Bắt buộc | Link bài viết, video hoặc username tài khoản cần tăng |
quantity |
Integer | Bắt buộc | Số lượng cần tăng (Phải nằm trong khoảng Min - Max) |
runs |
Integer | Tùy chọn | Số lần lặp lại đơn hàng (Drip-feed runs) |
interval |
Integer | Tùy chọn | Khoảng cách thời gian giữa các lần chạy (Tính bằng phút) |
{
"order": 104285
}
4. Tra Cứu Trạng Thái 1 Đơn Hàng (Action: status)
Kiểm tra tiến độ xử lý của một đơn hàng cụ thể thông qua mã đơn order.
| Tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
key | String | Bắt buộc | API Key của bạn |
action | String | Bắt buộc | Giá trị: status |
order | Integer | Bắt buộc | Mã ID đơn hàng cần kiểm tra |
{
"charge": "15000.00",
"start_count": "1250",
"status": "In progress",
"remains": "450",
"currency": "VND"
}
5. Tra Cứu Hàng Loạt Đơn Hàng (Action: status với orders)
Tra cứu trạng thái của nhiều đơn hàng cùng lúc, cách nhau bởi dấu phẩy (tối đa 100 đơn / lần gọi).
| Tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
key | String | Bắt buộc | API Key của bạn |
action | String | Bắt buộc | Giá trị: status |
orders | String | Bắt buộc | Danh sách ID cách nhau dấu phẩy (ví dụ: 101,102,103) |
{
"101": {
"charge": "25000.00",
"start_count": "500",
"status": "Completed",
"remains": "0",
"currency": "VND"
},
"102": {
"charge": "12000.00",
"start_count": "120",
"status": "Processing",
"remains": "880",
"currency": "VND"
},
"103": {
"error": "Incorrect order ID"
}
}
6. Kiểm Tra Số Dư Tài Khoản (Action: balance)
Tra cứu số dư khả dụng và loại tiền tệ đang lưu hành của tài khoản API.
{
"balance": "850000.00",
"currency": "VND"
}
7. Yêu Cầu Bảo Hành (Refill)
Gửi yêu cầu bảo hành chạy bù cho đơn hàng nếu dịch vụ có hỗ trợ Refill.
refill • Param: order (Mã đơn)refill_status • Param: refill (Mã refill){
"refill": 5821
}
8. Yêu Cầu Hủy Đơn (Cancel)
Yêu cầu hủy đơn hàng nếu máy chủ dịch vụ chưa bắt đầu chạy.
cancel • Param: orders (Ví dụ: 101,102)[
{
"order": 101,
"cancel": 1
}
]
💻 Mẫu Code Tích Hợp Các Ngôn Ngữ
# 1. Tạo đơn hàng mới curl -X POST "https://trumsmm.io.vn/api/v2" \ -d "key=YOUR_API_KEY" \ -d "action=add" \ -d "service=1" \ -d "link=https://www.facebook.com/post/12345" \ -d "quantity=1000" # 2. Kiểm tra số dư tài khoản curl -X POST "https://trumsmm.io.vn/api/v2" \ -d "key=YOUR_API_KEY" \ -d "action=balance"
⚠️ Bảng Mã Lỗi Phản Hồi (API Error Codes)
Khi yêu cầu không hợp lệ hoặc phát sinh lỗi, hệ thống sẽ trả về JSON chứa trường error hoặc error_code tương ứng:
| Mã lỗi (error_code) | Nội dung thông báo (error) | Nguyên nhân & Cách khắc phục |
|---|---|---|
invalid_key |
Invalid API key | Mã API Key không chính xác hoặc đã bị làm mới / thu hồi. |
disabled_account |
Account is locked or inactive | Tài khoản của bạn đang bị tạm khóa hoặc chưa được kích hoạt. |
rate_limited |
Too many requests | Đã vượt quá giới hạn request/phút. Vui lòng giảm tần suất gửi request. |
incorrect_action |
Incorrect action | Tham số action không đúng trong danh sách cho phép. |
incorrect_service |
Incorrect service ID | ID dịch vụ không tồn tại hoặc đã tạm đóng bán. |
incorrect_quantity |
Incorrect quantity (Min: x, Max: y) | Số lượng đặt nằm ngoài khoảng tối thiểu / tối đa của dịch vụ. |
insufficient_balance |
Not enough funds on balance | Số dư ví tài khoản không đủ để thanh toán đơn hàng này. |
incorrect_order |
Incorrect order ID | Mã đơn hàng không tồn tại hoặc không thuộc quyền sở hữu của bạn. |