Điều khiển proxy bằng code

1# ════════════════════════════════════════
2# Hướng dẫn gọi API bằng cURL / HTTP
3# ════════════════════════════════════════
4#
5# Base URL: https://nestproxy.com/api/client/
6# Auth: Gửi header "user-api-key: YOUR_API_KEY" cho endpoint yêu cầu Auth
7# API Key lấy ở: Dashboard → Tài khoản → API Key
8#
9# ── QUAN TRỌNG ──
10# Thay YOUR_API_KEY = API key thật của bạn
11# Thay YOUR_KEY = Proxy key thật (lấy ở Dashboard → Key của tôi)
12 
13# ═══════════════════════════════════════
14# THAO TÁC PROXY (QUAN TRỌNG NHẤT)
15# ═══════════════════════════════════════
16 
17# 1. Lấy IP proxy mới (không cần Auth)
18# → Trả về IP:Port để kết nối
19curl "https://nestproxy.com/api/client/proxy/available?proxy_key=YOUR_KEY"
20 
21# Lấy IP ở tỉnh cụ thể (ví dụ: Hà Nội = province_id 1)
22curl "https://nestproxy.com/api/client/proxy/available?proxy_key=YOUR_KEY&province_id=1"
23 
24# 2. Xem IP đang dùng hiện tại
25curl "https://nestproxy.com/api/client/proxy/current?proxy_key=YOUR_KEY"
26 
27# 3. Đổi IP — Bước 1: Xóa IP cũ, Bước 2: Gọi lại lệnh "Lấy IP mới" ở trên
28curl -X POST "https://nestproxy.com/api/client/proxy/remove?proxy_key=YOUR_KEY"
29 
30# ═══════════════════════════════════════
31# QUẢN LÝ KEY
32# ═══════════════════════════════════════
33 
34# 4. Xem chi tiết 1 key (không cần Auth — chỉ cần biết proxy_key)
35curl "https://nestproxy.com/api/client/key/detail?proxy_key=YOUR_KEY"
36 
37# 5. Xem tất cả key của bạn (cần Auth)
38curl -H "user-api-key: YOUR_API_KEY" \
39     "https://nestproxy.com/api/client/key/list"
40 
41# 6. Mua key mới (cần Auth — trừ tiền từ số dư)
42# keyType: "NORMAL" | "VIP" | "VIP_1H"
43# quantity: số lượng key muốn mua
44# duration: thời hạn sử dụng (ngày)
45curl -X POST -H "user-api-key: YOUR_API_KEY" \
46     -H "Content-Type: application/json" \
47     -d '{"keyType":"NORMAL","quantity":2,"duration":30}' \
48     "https://nestproxy.com/api/client/key/buy"
49 
50# 7. Gia hạn key sắp hết hạn (cần Auth)
51curl -X POST -H "user-api-key: YOUR_API_KEY" \
52     -H "Content-Type: application/json" \
53     -d '{"proxyKey":"proxy-key-uuid","duration":7}' \
54     "https://nestproxy.com/api/client/key/renewal"
55 
56# 8. Xóa key không dùng nữa (cần Auth)
57curl -X POST -H "user-api-key: YOUR_API_KEY" \
58     "https://nestproxy.com/api/client/key/remove?proxy_key=YOUR_KEY"
59 
60# ═══════════════════════════════════════
61# TÀI KHOẢN & TIỆN ÍCH
62# ═══════════════════════════════════════
63 
64# 9. Xem thông tin tài khoản + số dư (cần Auth)
65curl -H "user-api-key: YOUR_API_KEY" \
66     "https://nestproxy.com/api/client/user/current"
67 
68# 10. Đổi Gift Code lấy tiền vào tài khoản (cần Auth)
69curl -X POST -H "user-api-key: YOUR_API_KEY" \
70     -H "Content-Type: application/json" \
71     -d '{"code":"GIFT-CODE-ABC"}' \
72     "https://nestproxy.com/api/client/gift-code/redeem"
73 
74# ═══════════════════════════════════════
75# XEM THÔNG TIN CHUNG (KHÔNG CẦN AUTH)
76# ═══════════════════════════════════════
77 
78# 11. Lấy danh sách 63 tỉnh thành (lấy province_id dùng cho lệnh lấy IP)
79curl "https://nestproxy.com/api/client/provinces"
80curl "https://nestproxy.com/api/client/provinces?search_text=Hà Nội"
81 
82# 12. Xem bảng giá các loại key
83curl "https://nestproxy.com/api/client/pricing"
84 
85# ═══════════════════════════════════════
86# LỊCH SỬ (CẦN AUTH)
87# ═══════════════════════════════════════
88 
89# 13. Lịch sử đổi IP
90curl -H "user-api-key: YOUR_API_KEY" \
91     "https://nestproxy.com/api/client/ip-history"
92 
93# 14. Lịch sử mua / gia hạn key
94curl -H "user-api-key: YOUR_API_KEY" \
95     "https://nestproxy.com/api/client/key-orders"
96 
97# 15. Lịch sử nạp tiền
98curl -H "user-api-key: YOUR_API_KEY" \
99     "https://nestproxy.com/api/client/deposits"