VI VI
🔔 Thông báo
Proxy VSM

Số dư tài khoản

0đ

+ Nạp tiền

API Documentation

Tích hợp proxy vào ứng dụng của bạn

0

Tổng quan

Base URL

https://vproxy.live

Format

application/json

Auth (web endpoints)

Session cookie (sau khi login)

Auth (extension API)

?token={token}

💡 Tất cả endpoint /ajax/* yêu cầu đăng nhập qua session. Endpoint /api/* dùng token bearer cho Chrome extension.

1

Xác thực

POST /ajax/auth_login Đăng nhập
ParamTypeMô tả
usernamestringbắt buộcEmail hoặc username
passwordstringbắt buộcMật khẩu
// Response thành công
{ "success": true, "role": "user", "redirect": "/" }

⏱ Rate limit: 10 lần/phút/IP

POST /api/extension_auth Extension Login

⚡ Nhận params qua URL query string.

ParamTypeMô tả
usernamestringbắt buộcEmail hoặc username
passwordstringbắt buộcMật khẩu
{
  "success": true,
  "token": "eyJhbGciOi...",
  "user": {
    "id": 42, "username": "john",
    "balance": 150000, "role": "user"
  },
  "site_url": "https://vproxy.live"
}
2

Mua Proxy IPv4 Tĩnh

POST /ajax/buy_proxy 🔐 Yêu cầu login + email verified
ParamTypeGiá trị
loai_proxystringbắt buộcViettel, FPT, VNPT, DatacenterA/B/C, US... Xem đầy đủ ↓
so_luongintbắt buộc1–100
thoi_gianintbắt buộcTối thiểu 1
don_vistringbắt buộcngay / tuan / thang
type_proxystringbắt buộcHTTP / HTTPS / SOCKS5
user_proxystringtùy chọnĐể trống = tự tạo
pass_proxystringtùy chọnĐể trống = tự tạo
purchase_tokenstringbắt buộcNonce chống duplicate (lấy từ trang mua proxy)
{ "success": true, "message": "Mua 2 proxy thành công!", "order_id": 123 }
3

Gia hạn Proxy

POST /ajax/renew_proxy 🔐 Yêu cầu login

✅ Cho phép gia hạn cả proxy đã hết hạn để kích hoạt lại.

ParamTypeMô tả
proxy_idintbắt buộcID proxy trong hệ thống
proxy_typestringbắt buộcipv4 hoặc xoay
thoi_gianintbắt buộcSố đơn vị gia hạn
don_vistringbắt buộcngay / tuan / thang
{ "success": true, "message": "Gia hạn thành công!" }
4

Đổi IP Proxy

POST /ajax/change_proxy 🔐 Yêu cầu login
ParamTypeMô tả
proxy_idintbắt buộcID proxy
loai_proxy_nhanstringtùy chọnLoại proxy muốn đổi sang (để trống = cùng loại)
{
  "success": true, "message": "Đổi IP thành công!",
  "new_ip": "14.225.1.100",
  "new_port": "8080",
  "proxy_string": "14.225.1.100:8080:user:pass"
}
5

Đổi bảo mật (User/Pass/Type)

POST /ajax/change_proxy_auth 💰 Miễn phí
ParamTypeMô tả
proxy_idintbắt buộcID proxy
type_proxystringtùy chọnHTTP / HTTPS / SOCKS5
user_proxystringtùy chọn4–32 ký tự (a-z, 0-9, _)
pass_proxystringtùy chọn6–32 ký tự (a-z, 0-9, @#!)
{
  "success": true,
  "new_user": "user123",
  "new_pass": "pass456",
  "proxy_string": "1.2.3.4:8080:user123:pass456"
}
6

Kiểm tra Proxy Live

POST /ajax/check_proxy_live
ParamType
proxy_idintbắt buộc
// Proxy sống
{ "live": true, "ip": "14.225.1.100", "isp": "Viettel", "latency": 245 }

// Proxy chết
{ "live": false, "error": "Connection refused" }
7

Bật/Tắt Tự gia hạn

POST /ajax/toggle_auto_renew
ParamTypeMô tả
proxy_idintbắt buộc
enableintbắt buộc1 = bật, 0 = tắt
{ "success": true, "message": "Đã bật tự gia hạn." }
8

Kho lưu trữ

POST /ajax/archive_proxy
ParamTypeMô tả
actionstringbắt buộcarchive hoặc restore
ids[]int[]bắt buộcDanh sách proxy ID
{ "success": true, "message": "Đã lưu kho 3 proxy." }
9

Mua Key Proxy Xoay

POST /ajax/buy_xoay 🔐 Yêu cầu login
ParamType
so_luongintbắt buộc
thoi_gianintbắt buộc
don_vistringbắt buộc
{ "success": true, "message": "Mua key xoay thành công!", "keys": ["key123abc..."] }
10

Lấy Proxy từ Key Xoay

POST /ajax/get_xoay
ParamTypeMô tả
key_idintbắt buộcID key trong DB
nhamangstringtùy chọnLọc theo nhà mạng
tinhthanhstringtùy chọnLọc theo tỉnh thành
{
  "success": true,
  "proxyhttps": "http://proxy.host:port",
  "proxysocks": "socks5://proxy.host:port",
  "ip": "14.225.10.5",
  "nhamang": "Viettel",
  "vitri": "Hà Nội"
}
11

Proxy Miễn phí

POST /ajax/get_free_proxy 🔐 Yêu cầu login

⏱ Giới hạn số lượt/ngày theo cấu hình admin.

{ "success": true, "proxy": "http://ip:port:user:pass", "remaining": 3 }
12

Hồ sơ người dùng

POST /ajax/update_profile?action={action}

💡 Đặt action trong URL query string (?action=...) để đảm bảo hoạt động đúng qua hosting redirect.

actionParams bổ sung trong body
update_phonephone
update_emailemail
change_passwordcurrent_password, new_password, confirm_password
resend_verify—
setup_2fa— (trả về QR code URL)
enable_2fatotp_code
disable_2fatotp_code, password
{ "success": true, "message": "Đã cập nhật số điện thoại." }
13

Extension API

GET /api/extension_proxies?token={token}
{
  "success": true,
  "proxies": [
    {
      "id": 1,
      "loai_proxy": "Viettel",
      "proxy_string": "1.2.3.4:8080:user:pass",
      "type_proxy": "HTTP",
      "expired_at": "2025-04-01 00:00:00",
      "status": "active"
    }
  ]
}
14

Mã lỗi

HTTPJSON messageNguyên nhân
200success: falseLỗi logic (xem message)
200Số dư không đủBalance < tổng tiền
200Token mua hàng không hợp lệThiếu purchase_token
200Quá nhiều lần thửRate limit (10 req/phút)
200Bạn cần xác thực emailEmail chưa verify
403—Chưa đăng nhập / session hết hạn
15

Loại Proxy IPv4 hợp lệ

Key (loai_proxy)Mô tả
Viettel 4G Viettel
FPT 4G FPT
VNPT 4G VNPT
ISPViettel Dân cư tĩnh Viettel
ISPFPT Dân cư tĩnh FPT
ISPVNPT Dân cư tĩnh VNPT
US Quốc tế (US)
DatacenterA Datacenter A
DatacenterB Datacenter B
DatacenterC Datacenter C
GoiViettel Gói tháng Viettel
GoiVNPT Gói tháng VNPT
GoiDATACENTER Gói tháng Datacenter