vi en zh-CN ja
Đăng ký

Tài Liệu Kết Nối API Proxy

Tích hợp và quản lý Proxy tự động dành cho lập trình viên và nhà phát triển.

1. API Lấy & Xoay Proxy (Get Proxy với Key Xoay)
GET / POST

Sử dụng phương thức GET hoặc POST truyền key nhận được khi mua hàng để lấy proxy hoặc kích hoạt xoay IP theo nhà mạng và vị trí tỉnh thành.

https://webproxy.vn/apiv1/xoay/get.php
https://webproxy.vn/apiv1/xoay/get.php?key=YOUR_KEY&nhamang=viettel&tinhthanh=3&whitelist=1.2.3.4
Thay thế YOUR_KEY bằng key của bạn để chạy thử trực tiếp trên trình duyệt hoặc tool.
Danh Sách Tham Số (Parameters):
Tham số Bắt buộc Giá trị hợp lệ Mô tả chi tiết
key Bắt buộc Chuỗi ký tự Key proxy nhận được khi bạn mua hàng trên website.
nhamang Tùy chọn Random, viettel, fpt, vnpt Nhà mạng muốn lấy proxy (mặc định: Random).
tinhthanh Tùy chọn Mã tỉnh (0, 1, 2, 3...) Mã tỉnh liệt kê bên dưới (mặc định: 0 - Random).
whitelist Tùy chọn 1.2.3.4,5.6.7.8 Khai thêm danh sách IPv4 được phép sử dụng proxy.
Danh Sách Mã Tỉnh Thành (tinhthanh):
0 Random
1 Phú Thọ
2 Tuyên Quang
3 Hà Nội
4 Hải Dương
5 Bắc Giang
6 Hồ Chí Minh
7 Tây Ninh
8 Đồng Nai
9 Vũng Tàu
10 Bình Dương
11 Nghệ An
12 Hà Tĩnh
13 Quảng Bình
14 Quảng Trị
15 Huế
16 Đà Nẵng
17 Vĩnh Phúc
18 Yên Bái
19 Lào Cai
20 Lạng Sơn
21 Thái Nguyên
22 Hà Nam
23 Nam Định
24 Thái Bình
25 Hải Phòng
26 Quảng Ninh
27 Cà Mau
28 Kiên Giang
29 Bạc Liêu
30 Sóc Trăng
31 Hậu Giang
- Bắc Ninh
- Hưng Yên
- Ninh Bình
- Thanh Hoá
- Quảng Nam
- Khánh Hoà
- Lâm Đồng
- Cần Thơ
Ví Dụ Request:
# 1. Gọi phương thức GET
curl "https://webproxy.vn/apiv1/xoay/get.php?key=YOUR_KEY&nhamang=viettel&tinhthanh=3"

# 2. Gọi phương thức POST
curl -X POST "https://webproxy.vn/apiv1/xoay/get.php" \
  -d "key=YOUR_KEY" \
  -d "nhamang=fpt" \
  -d "tinhthanh=6"
Kết Quả Trả Về (JSON Response):

Kết quả thành công (status = 100):

{
  "status": 100,
  "message": "proxy nay se die sau 1777s",
  "proxyhttp": "42.117.243.215:10836::",
  "proxysocks5": "42.117.243.215:30836::",
  "Nha Mang": "fpt",
  "Vi Tri": "HaNoi1",
  "Token expiration date": "22:52 19-02-2025"
}

Kết quả lỗi (status = 101, 102):

# Lỗi key không tồn tại / hết hạn (status = 102)
{
  "status": 102,
  "message": "key khong ton tai"
}

# Lỗi chưa truyền key (status = 101)
{
  "status": 101,
  "message": "Key khong ton tai hoac chua truyen tham so key"
}
2. API Mua Key Proxy Xoay (Mua Mới Tự Động)
Đang cập nhật

Tạo đơn hàng mua Key Xoay IPv4 (gói Ngày, Tuần, Tháng) tự động trừ tiền từ số dư tài khoản của bạn.

https://webproxy.vn/apiv1/xoay/buy.php Đang phát triển
Tính năng API Mua Key Tự Động đang được tích hợp và sẽ sớm mở chính thức cho khách hàng đấu API.
3. API Gia Hạn Key Proxy Xoay (Gia Hạn Tự Động)
Đang cập nhật

Gia hạn thời gian sử dụng cho Key Xoay hiện có mà không làm thay đổi chuỗi Key của bạn.

https://webproxy.vn/apiv1/xoay/renew.php Đang phát triển
Tính năng API Gia Hạn Key Xoay Tự Động đang được nâng cấp hệ thống.
4. API Lấy Danh Sách Key Xoay (List Keys Đã Mua)
Đang cập nhật

Truy vấn toàn bộ danh sách các key xoay đang hoạt động, hạn dùng, trạng thái và IP hiện tại của bạn.

https://webproxy.vn/apiv1/xoay/list.php Đang phát triển
Tài liệu API Tra Cứu Danh Sách Key Xoay sẽ sớm ra mắt.