Tài Liệu Tích Hợp API
Kết nối hệ thống tự động, đặt hàng và quản lý tài nguyên qua REST API tốc độ cao
Cổng kết nối API
Phương thức truyền tải
Xác thực yêu cầu
key kèm trong body request của mọi tác vụ.
Danh Mục & Tham Số API
Lấy số dư hiện tại và thông tin tài khoản.
Lấy toàn bộ danh sách dịch vụ SMM, ID, tỉ giá, mức đặt tối thiểu/tối đa.
Tham số: service, link, quantity, comments (tùy chọn).
Tham số: order (Mã đơn hàng).
Lấy danh mục, tồn kho và đơn giá từng loại via.
Tham số: product_id, amount (số lượng).
Tra cứu danh sách gói, quốc gia, thời hạn và đơn giá.
Tham số: package_code, quantity, country (mặc định VN).
Tham số: order_id (Mã đơn hàng Proxy cần gia hạn).
Lấy các dịch vụ giải trí / làm việc / AI kèm gói cước.
Tham số: product_id, quantity.
Lấy danh sách sản phẩm mã nguồn, demo link và giá bán.
Tham số: product_id. Trả về liên kết tải về an toàn.
Bảng Quy Ước Mã Lỗi (Response Status & HTTP Codes)
| HTTP Code | Nội dung phản hồi (Error message) | Ý nghĩa & Hướng xử lý |
|---|---|---|
| 401 | Missing API Key |
Thiếu trường key trong payload gửi lên. |
| 401 | Invalid API Key |
API Key không tồn tại hoặc tài khoản người dùng đang bị tạm khóa. |
| 403 | Please verify your email |
Tài khoản chưa hoàn tất kích hoạt qua email đăng ký. |
| 400 | Invalid action |
Tham số action không đúng hoặc không được hỗ trợ. |
| 500 | Insufficient balance |
Số dư tài khoản không đủ để thanh toán đơn hàng này. Vui lòng nạp thêm tiền. |
| 429 | Too many requests |
Vượt ngưỡng tần suất gọi (Rate Limit). Khuyến nghị tối đa 60 requests/phút. |
Ví Dụ Triển Khai Code
<?php
$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://v3vn.eu/api/v2';
$data = [
'key' => $apiKey,
'action' => 'balance'
];
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
echo "Số dư: " . number_format($result['balance'] ?? 0) . " đ";
?>
const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://v3vn.eu/api/v2';
const formData = new FormData();
formData.append('key', apiKey);
formData.append('action', 'balance');
fetch(apiUrl, {
method: 'POST',
body: formData
})
.then(res => res.json())
.then(data => {
console.log('Balance:', data.balance);
})
.catch(err => console.error('Lỗi gọi API:', err));
import requests
api_key = 'YOUR_API_KEY'
api_url = 'https://v3vn.eu/api/v2'
payload = {
'key': api_key,
'action': 'balance'
}
response = requests.post(api_url, data=payload)
data = response.json()
print(f"Số dư tài khoản: {data.get('balance', 0):,} VND")
const axios = require('axios');
const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://v3vn.eu/api/v2';
const params = new URLSearchParams({
key: apiKey,
action: 'balance'
});
axios.post(apiUrl, params)
.then(response => {
console.log('Balance:', response.data.balance);
})
.catch(error => {
console.error('Lỗi request:', error);
});
Cần Hỗ Trợ Tích Hợp Kỹ Thuật?
Đội ngũ kỹ thuật sẵn sàng hỗ trợ bạn kết nối API và kiểm thử hệ thống 24/7.