Tài Liệu Tích Hợp API (Developer REST API)
Tích hợp mua VIA/Clone tự động, kiểm tra tồn kho realtime, tra cứu đơn hàng, kiểm tra nạp tiền VietQR và tiện ích MMO vào Bot, Web con hoặc Auto Tool của bạn.
API Key Xác Thực Cá Nhân Của Bạn
Vui lòng Đăng nhập tài khoản để xem và sử dụng API Key riêng của bạn.
Quy Chuẩn Xác Thực (Authentication)
Tất cả các API yêu cầu xác thực đều hỗ trợ linh hoạt 3 phương thức truyền API Key tùy theo ngôn ngữ lập trình của bạn:
Dữ liệu phản hồi luôn trả về định dạng JSON chuẩn UTF-8 với mã HTTP tương ứng (200, 400, 401, 403, 404).
GET / POST
1. Kiểm Tra Thông Tin Tài Khoản & Số Dư
Tra cứu số dư ví hiện tại, cấp bậc VIP, mức chiết khấu giảm giá và trạng thái hoạt động của tài khoản.
https://sellvia24h.site/api/me.php
| Tham Số | Vị Trí | Kiểu | Bắt Buộc | Mô Tả |
|---|---|---|---|---|
apikey |
Header / Query | String | Bắt buộc | Mã API Key cá nhân của bạn |
curl -X GET "https://sellvia24h.site/api/me.php?apikey=YOUR_API_KEY_HERE" \
-H "Accept: application/json"
<?php
$ch = curl_init('https://sellvia24h.site/api/me.php?apikey=YOUR_API_KEY_HERE');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
import requests
url = "https://sellvia24h.site/api/me.php"
params = {"apikey": "YOUR_API_KEY_HERE"}
response = requests.get(url, params=params)
print(response.json())
const axios = require('axios');
axios.get('https://sellvia24h.site/api/me.php', {
params: { apikey: 'YOUR_API_KEY_HERE' }
})
.then(res => console.log(res.data))
.catch(err => console.error(err));
{
"status": "success",
"code": 200,
"data": {
"user_id": 1,
"username": "nguyenvana",
"email": "user@gmail.com",
"balance": 250000,
"balance_formatted": "250.000 VNĐ",
"role": "user",
"level_id": 2,
"level_name": "VIP 1 - Đại Lý",
"discount_percent": 5,
"status": "active"
}
}
GET
2. Lấy Danh Sách Sản Phẩm & Tồn Kho Realtime
Lấy toàn bộ danh mục, sản phẩm đang mở bán, giá tiền, số lượng tồn kho khả dụng tức thời và hướng dẫn định dạng tài khoản.
https://sellvia24h.site/api/products.php
| Tham Số | Vị Trí | Kiểu | Bắt Buộc | Mô Tả |
|---|---|---|---|---|
category_id |
Query | Integer | Tùy chọn | Lọc theo ID chuyên mục sản phẩm (VD: 1 cho VIA Facebook) |
curl -X GET "https://sellvia24h.site/api/products.php" \
-H "Accept: application/json"
<?php
$response = file_get_contents('https://sellvia24h.site/api/products.php');
$products = json_decode($response, true);
print_r($products);
import requests
response = requests.get("https://sellvia24h.site/api/products.php")
print(response.json())
{
"status": "success",
"code": 200,
"total": 3,
"data": [
{
"id": 1,
"category_id": 1,
"category_name": "VIA Facebook Việt Nam",
"name": "VIA Việt Cổ 2012-2018 | 2FA + Mail | Live Siêu Trâu",
"price": 55000,
"original_price": 70000,
"price_formatted": "55.000 VNĐ",
"stock": 42,
"badge": "HOT",
"description": "Bảo hành pass 24h, kèm mã 2FA và mật khẩu mail",
"format_guide": "UID|Pass|2FA|Mail|PassMail"
}
]
}
POST
3. Mua Nguyên Liệu Tức Thì (Instant Purchase)
Thực hiện mua VIA/Clone với tốc độ phản hồi cực nhanh (< 200ms). Hệ thống kiểm tra số dư, trừ tiền an toàn và trả về danh sách tài khoản ngay trong JSON.
https://sellvia24h.site/api/buy.php
| Tham Số | Vị Trí | Kiểu | Bắt Buộc | Mô Tả |
|---|---|---|---|---|
apikey |
Header / Body | String | Bắt buộc | Mã API Key của bạn |
product_id |
JSON / Form | Integer | Bắt buộc | Mã ID sản phẩm cần mua (lấy từ /api/products.php) |
quantity |
JSON / Form | Integer | Bắt buộc | Số lượng cần mua (từ 1 đến 500) |
curl -X POST "https://sellvia24h.site/api/buy.php" \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY_HERE" \
-d '{
"product_id": 1,
"quantity": 2
}'
<?php
$ch = curl_init('https://sellvia24h.site/api/buy.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'X-API-KEY: YOUR_API_KEY_HERE'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'product_id' => 1,
'quantity' => 2
]));
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
import requests
url = "https://sellvia24h.site/api/buy.php"
headers = {"X-API-KEY": "YOUR_API_KEY_HERE"}
payload = {
"product_id": 1,
"quantity": 2
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
class Program {
static async Task Main() {
var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-KEY", "YOUR_API_KEY_HERE");
var json = "{\"product_id\":1,\"quantity\":2}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://sellvia24h.site/api/buy.php", content);
var result = await res.Content.ReadAsStringAsync();
Console.WriteLine(result);
}
}
{
"status": "success",
"code": 200,
"message": "Giao dịch mua tài nguyên thành công!",
"order_code": "API_4F89A120_1786956000",
"product_id": 1,
"product_name": "VIA Việt Cổ 2012-2018 | 2FA + Mail",
"quantity": 2,
"unit_price": 55000,
"total_amount": 110000,
"balance_remaining": 140000,
"accounts": [
"10008928172819|Pass123|JBSWY3DPEHPK3PXP|mail1@outlook.com|MailPass123",
"10008928172820|Pass456|KBSWY3DPEHPK3PXP|mail2@outlook.com|MailPass456"
]
}
GET / POST
4. Quản Lý Lịch Sử Đơn Hàng & Lấy Lại Tài Khoản
Tra cứu danh sách 50 đơn hàng gần nhất hoặc trích xuất lại toàn bộ danh sách tài khoản của một đơn hàng cụ thể bằng mã order_code.
https://sellvia24h.site/api/orders.php?apikey=YOUR_API_KEY_HERE&order_code=API_XXXXXX
| Tham Số | Vị Trí | Kiểu | Bắt Buộc | Mô Tả |
|---|---|---|---|---|
apikey |
Header / Query | String | Bắt buộc | Mã API Key cá nhân của bạn |
order_code |
Query / Body | String | Tùy chọn | Nếu truyền mã đơn hàng: trả về chi tiết kèm danh sách tài khoản. Nếu bỏ trống: trả về 50 đơn gần nhất. |
curl -X GET "https://sellvia24h.site/api/orders.php?apikey=YOUR_API_KEY_HERE&order_code=API_4F89A120_1786956000" \
-H "Accept: application/json"
<?php
$orderCode = 'API_4F89A120_1786956000';
$url = 'https://sellvia24h.site/api/orders.php?apikey=YOUR_API_KEY_HERE&order_code=' . $orderCode;
$response = file_get_contents($url);
print_r(json_decode($response, true));
{
"status": "success",
"code": 200,
"data": {
"order_id": 105,
"order_code": "API_4F89A120_1786956000",
"product_name": "VIA Việt Cổ 2012-2018 | 2FA + Mail",
"quantity": 1,
"unit_price": 55000,
"total_amount": 55000,
"status": "completed",
"created_at": "2026-08-30 08:30:15",
"accounts": [
"10008928172819|Pass123|JBSWY3DPEHPK3PXP|mail1@outlook.com|MailPass123"
]
}
}
GET
5. Tra Cứu Trạng Thái Hóa Đơn Nạp Tiền Tự Động
Kiểm tra trạng thái hóa đơn nạp VietQR / PayOS theo thời gian thực (realtime polling).
https://sellvia24h.site/api/check_payos_status.php?order_code=1788050000
| Tham Số | Vị Trí | Kiểu | Bắt Buộc | Mô Tả |
|---|---|---|---|---|
order_code |
Query | Integer | Bắt buộc | Mã số hóa đơn PayOS đã khởi tạo lúc nạp tiền |
{
"status": "PAID",
"amount": 100000,
"user_balance": 350000,
"balance_fmt": "350.000 VNĐ"
}
POST / GET
6. Tiện Ích API: Tạo Mã 2FA TOTP 6 Số (2FA Generator)
API tạo mã 2FA 6 số theo thuật toán RFC 6238. Hỗ trợ truyền khóa Secret Base32 hoặc truyền nguyên chuỗi định dạng UID|Pass|2FA_KEY|Mail|Passmail.
https://sellvia24h.site/ajax/get_2fa.php?secret=JBSWY3DPEHPK3PXP
curl -X POST "https://sellvia24h.site/ajax/get_2fa.php" \
-d "secret=JBSWY3DPEHPK3PXP"
{
"status": true,
"code": "481920",
"time_remaining": 24,
"secret": "JBSWY3DPEHPK3PXP"
}
GET / POST
7. Tiện Ích API: Kiểm Tra UID Facebook Live / Die
Kiểm tra trạng thái sống/chết (Live or Die) của tài khoản Facebook theo UID công khai.
https://sellvia24h.site/ajax/check_live_fb.php?uid=4
curl -X GET "https://sellvia24h.site/ajax/check_live_fb.php?uid=10008928172819"
{
"success": true,
"uid": "10008928172819",
"status": "LIVE",
"time": "09:30:15"
}
POST
8. Tiện Ích API: Đọc Email & Tự Động Trích Xuất Mã OTP
Đọc hộp thư Hotmail / Outlook (hỗ trợ OAuth2 / Refresh Token / IMAP / POP3) và tự động nhận diện mã OTP 6 số.
https://sellvia24h.site/ajax/read_mail.php
curl -X POST "https://sellvia24h.site/ajax/read_mail.php" \
-d "action=read_oauth2&email=yourmail@outlook.com&refresh_token=M.R3_BAY..."
{
"success": true,
"otp": "829104",
"subject": "Your Facebook confirmation code",
"from": "security@facebookmail.com",
"date": "2026-08-30 09:25:00"
}
Interactive API Console
Trình Test & Thử Nghiệm API Trực Tiếp (Sandbox)
Response Header & JSON Output:
---
// Kết quả phản hồi thực tế từ máy chủ sẽ hiển thị tại đây...
Bảng Mã Lỗi (HTTP Status & Error Codes)
| HTTP Code | Trạng Thái | Ý Nghĩa / Nguyên Nhân | Cách Xử Lý |
|---|---|---|---|
| 200 OK | success |
Yêu cầu thành công, dữ liệu được xử lý hoàn tất. | Đọc mảng data hoặc accounts trong JSON. |
| 400 Bad Request | error |
Thiếu tham số bắt buộc (VD: product_id, quantity) hoặc số lượng mua không hợp lệ. |
Kiểm tra lại giá trị các trường gửi lên máy chủ. |
| 401 Unauthorized | error |
Chưa truyền API Key trong Header X-API-KEY hoặc tham số apikey. |
Truyền đầy đủ API Key hợp lệ. |
| 403 Forbidden | error |
API Key không chính xác hoặc tài khoản người dùng đang bị khóa. | Kiểm tra lại API Key trong mục Trang Cá Nhân. |
| 404 Not Found | error |
Sản phẩm không tồn tại, đã tắt bán, hoặc không tìm thấy mã đơn hàng. | Gọi /api/products.php để lấy danh sách sản phẩm còn hoạt động. |
| 400 OUT_OF_STOCK | error |
Sản phẩm tạm thời hết hàng hoặc số lượng tồn kho khả dụng ít hơn số lượng đặt mua. | Giảm số lượng mua hoặc kiểm tra lại tồn kho realtime. |
| 400 INSUFFICIENT_BALANCE | error |
Số dư tài khoản không đủ để thanh toán giá trị đơn hàng. | Nạp thêm tiền vào tài khoản qua VietQR / PayOS tự động. |