ProxyXoay API

Endpoint

Hỗ trợ GET và OPTIONS (CORS preflight). Các route khác trả về JSON 404.

Tham số truy vấn

Tham số	Bắt buộc	Mặc định	Mô tả
key	Có	—	API key của proxyxoay.shop
nhamang	Không	random	Nhà mạng (vd: fpt, viettel, vnpt, random)
tinhthanh	Không	0	Mã tỉnh/thành
whitelist	Không	rỗng	IPv4 được phép sử dụng proxy

Ví dụ

Request

GET /api/get?key=YOUR_KEY&nhamang=random&tinhthanh=0&whitelist=

Response thành công (HTTP 200)

{
  "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"
}

curl

curl "https://proxyxoay.phuocan.dev/api/get?key=YOUR_KEY&nhamang=random&tinhthanh=0&whitelist="

Mã trạng thái

status	Ý nghĩa
100	Thành công — có proxy, trả kèm proxyhttp / proxysocks5
101	Lỗi từ upstream (vd: key sai / hết lượt) — giữ nguyên message
102	Lỗi từ upstream — giữ nguyên message
400	Thiếu API key
404	Route không tồn tại
502	Upstream không phản hồi / response không hợp lệ
504	Upstream timeout

CORS

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, OPTIONS
Access-Control-Allow-Headers: Content-Type

Mọi response đều kèm header CORS, gọi được trực tiếp từ trình duyệt.