Thông Tin Cơ Bản
Tổng Quan API
Mọi thứ bạn cần để bắt đầu kết nối với hệ thống của chúng tôi.
Phương Thức HTTP
POST
URL API
https://trumsubviet.com/api/v2
Click để copy
Định Dạng Phản Hồi
JSON
API Key Của Bạn
●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●
Bảo Mật
Lấy API key tại TrumSubViet.com → Tài Khoản → API Key sau khi đăng nhập.
Quan trọng: Không bao giờ chia sẻ API key với bất kỳ ai. Key bị lộ có thể dẫn đến mất tiền.
Nếu nghi ngờ key bị lộ, vào trang tài khoản để tạo lại key mới ngay lập tức.
Xác Thực (Authentication)
Tất cả requests đều cần API key trong POST body với tham số key.
PHP
<?php $url = 'https://trumsubviet.com/api/v2'; $data = ['key' => 'your-api-key', 'action' => 'services']; $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $result = json_decode(curl_exec($ch), true); curl_close($ch); print_r($result); ?>
Tài Liệu API
Các Endpoints
Tất cả endpoint dùng cùng URL, phân biệt bằng tham số action.
POST
Danh Sách Dịch Vụ
Truy xuất toàn bộ dịch vụ có sẵn kèm giá, giới hạn và mô tả.
| Tham Số | Mô Tả |
|---|---|
| keyrequired | API key của bạn |
| actionrequired | services |
📤 Request
JSON
{ "key": "your-api-key", "action": "services" }📥 Response
JSON
[{
"service": 1,
"name": "YouTube Views",
"type": "Default",
"category": "YouTube",
"rate": "2.5",
"min": "200",
"max": "10000",
"refill": true
}]
POST
Kiểm Tra Số Dư
Lấy số dư tài khoản hiện tại của bạn theo USD.
| Tham Số | Mô Tả |
|---|---|
| keyrequired | API key của bạn |
| actionrequired | balance |
📤 Request
JSON
{ "key": "your-api-key", "action": "balance" }📥 Response
JSON
{ "balance": "100.84", "currency": "USD" }
POST
Tạo Đơn Hàng
Đặt đơn hàng mới. Hỗ trợ reactions và mã tham chiếu riêng.
| Tham Số | Mô Tả |
|---|---|
| keyrequired | API key của bạn |
| actionrequired | add |
| servicerequired | ID dịch vụ |
| linkrequired | Link trang / bài đăng |
| quantityrequired | Số lượng cần thiết |
| reactionsoptional | like, love, care, haha, wow, sad, angry |
| order_referenceoptional | Mã tham chiếu riêng (≤100 ký tự) |
📤 Request
JSON
{
"key": "your-api-key",
"action": "add",
"service": 1,
"link": "https://facebook.com/user",
"quantity": 1000,
"reactions": ["like","love"],
"order_reference": "MY-ORDER-001"
}📥 Response
JSON
{
"order": 23501,
"message": "Order created successfully",
"data": {
"id": 23501,
"charge": "0.90",
"status": "pending",
"currency": "USD"
}
}💡 Duplicate Reference: Nếu order_reference đã tồn tại, API trả về đơn cũ — tránh tạo đơn trùng lặp.
POST
Trạng Thái Đơn Hàng
Lấy trạng thái một hoặc nhiều đơn (tối đa 100 ID).
| Tham Số | Mô Tả |
|---|---|
| keyrequired | API key của bạn |
| actionrequired | status |
| ordersingle | ID đơn hàng (một đơn) |
| ordersbatch | Danh sách ID ngăn bởi dấu phẩy (≤100) |
📤 Single
JSON
{ "key": "your-api-key", "action": "status", "order": 23501 }📥 Response
JSON
{ "charge": "0.90", "start_count": "1250", "status": "Completed", "remains": "0" }
POST
Bảo Hành (Refill)
Yêu cầu bảo hành cho đơn hàng hỗ trợ. Batch tối đa 100.
| Tham Số | Mô Tả |
|---|---|
| keyrequired | API key của bạn |
| actionrequired | refill |
| ordersingle | ID đơn hàng (một đơn) |
| ordersbatch | Danh sách ID (≤100) |
📤 Single
JSON
{ "key": "your-api-key", "action": "refill", "order": 23501 }📤 Batch
JSON
{ "key": "your-api-key", "action": "refill", "orders": "23501,23502" }
POST
Hủy Đơn Hàng
Hủy một hoặc nhiều đơn đang chờ. Batch tối đa 100.
| Tham Số | Mô Tả |
|---|---|
| keyrequired | API key của bạn |
| actionrequired | cancel |
| ordersingle | ID đơn hàng (một đơn) |
| ordersbatch | Danh sách ID (≤100) |
📤 Single
JSON
{ "key": "your-api-key", "action": "cancel", "order": 23501 }📤 Batch
JSON
{ "key": "your-api-key", "action": "cancel", "orders": "23501,23502" }Xử Lý Lỗi
Error Responses
Tất cả lỗi đều trả về JSON với trường error. Dưới đây là các mã lỗi thường gặp.
401
Unauthorized — API Key không hợp lệ
API key không tồn tại hoặc đã bị vô hiệu hóa. Kiểm tra lại key trong tài khoản.
JSON
{ "error": "Invalid API key" }
400
Bad Request — Thiếu hoặc sai tham số
Request thiếu tham số bắt buộc hoặc giá trị không hợp lệ (link sai, quantity vượt min/max).
JSON
{ "error": "Incorrect quantity" }
403
Forbidden — Không đủ số dư
Tài khoản không có đủ số dư để thực hiện đơn hàng. Vui lòng nạp thêm tiền.
JSON
{ "error": "Not enough funds" }
404
Not Found — Không tìm thấy đơn / dịch vụ
ID dịch vụ hoặc đơn hàng không tồn tại trong hệ thống.
JSON
{ "error": "Order not found" }
429
Too Many Requests — Vượt giới hạn rate limit
Quá nhiều request trong thời gian ngắn. Thêm delay giữa các request hoặc dùng batch API.
JSON
{ "error": "Too many requests" }
500
Server Error — Lỗi hệ thống nội bộ
Lỗi phía server. Vui lòng thử lại sau ít phút hoặc liên hệ hỗ trợ nếu lỗi kéo dài.
JSON
{ "error": "Internal server error" }Thử Nghiệm Live
API Playground
Nhập API key và gọi API trực tiếp. Kết quả thực từ server TrumSubViet.Com
▶ Playground
Sẵn sàng
key
action