Dành cho lập trình viên muốn tự động hóa việc lấy IP, đổi IP và quản lý key proxy. Hỗ trợ SDK TypeScript và gọi trực tiếp qua HTTP/cURL — copy code là chạy.
npm install @nestproxy/sdk — gọi API type-safe, có autocomplete đầy đủ, chạy ngay không cần cấu hình.
Truyền province_id khi lấy IP để nhận proxy ở đúng tỉnh thành bạn cần. Hỗ trợ 63 tỉnh.
Gửi API Key qua header user-api-key — không cần OAuth, không cần token, đơn giản nhất có thể.
Bạn chỉ cần 2 thứ: API Key (lấy ở Dashboard → Tài khoản) và Proxy Key (lấy ở Dashboard → Key của tôi)
Đăng nhập Dashboard. Vào Tài khoản để copy API Key. Vào Key của tôi để lấy Proxy Key (hoặc mua key nếu chưa có).
# API Key → dùng cho header xác thực # Proxy Key → dùng để chỉ định key nào cần lấy/đổi IP
Gọi endpoint /proxy/available với proxy_key của bạn. Server sẽ trả về IP:Port để kết nối.
curl "https://nestproxy.com/api/client/proxy/available?proxy_key=YOUR_KEY"
Khi muốn đổi IP, gọi /proxy/remove để xóa IP cũ, sau đó gọi lại /proxy/available để lấy IP mới.
# Bước a: Xóa IP cũ curl -X POST "https://nestproxy.com/api/client/proxy/remove?proxy_key=YOUR_KEY" # Bước b: Lấy IP mới curl "https://nestproxy.com/api/client/proxy/available?proxy_key=YOUR_KEY"
Mẹo: Đổi IP = 2 bước
Luôn nhớ: Xóa IP cũ trước (POST /proxy/remove), rồi mới lấy IP mới (GET /proxy/available). Nếu gọi lấy IP mới mà chưa xóa IP cũ, server sẽ trả về IP giống lần trước.
Chia thành 4 nhóm: Thao tác proxy, Quản lý key, Thông tin chung và Tài khoản. Mỗi endpoint kèm mô tả chi tiết và tham số cần truyền.
Endpoint có nhãn Cần API Key yêu cầu bạn gửi header sau trong mỗi request:
user-api-key: YOUR_API_KEY📍 Lấy API Key ở đâu? Đăng nhập → Dashboard → Tài khoản → Copy API Key.
Endpoint có nhãn Công khai không cần gửi header — gọi trực tiếp là được.
/api/client/proxy/availableGọi để nhận 1 IP proxy mới. Trả về IP:Port để kết nối.
/api/client/proxy/currentKiểm tra IP đang sử dụng và thời gian có thể đổi IP tiếp.
/api/client/proxy/removeXóa IP hiện tại. Sau đó gọi 'Lấy IP mới' để nhận IP khác.
/api/client/key/detailXem trạng thái, loại key, ngày hết hạn của 1 key cụ thể.
/api/client/key/listXem toàn bộ key đang có trong tài khoản của bạn.
/api/client/key/buyMua key proxy mới, trừ tiền từ số dư tài khoản.
/api/client/key/renewalGia hạn thêm ngày sử dụng cho key sắp hết hạn.
/api/client/key/removeXóa vĩnh viễn key không dùng nữa khỏi tài khoản.
/api/client/provincesLấy danh sách 63 tỉnh thành kèm ID. Dùng ID để chọn vùng khi lấy IP.
/api/client/pricingXem giá các loại key (Thường, VIP, VIP 1h) theo ngày.
/api/client/user/currentXem tên, email, số dư và thông tin tài khoản hiện tại.
/api/client/gift-code/redeemNhập gift code để nạp tiền vào tài khoản.
/api/client/ip-historyXem lại tất cả các lần lấy IP và đổi IP trước đó.
/api/client/key-ordersXem lại các đơn mua key và gia hạn key.
/api/client/depositsXem lại tất cả giao dịch nạp tiền vào tài khoản.
Copy và chỉnh sửa cho phù hợp với dự án của bạn. Code có comment tiếng Việt chi tiết từng bước.
1import { NestProxySDK } from '@nestproxy/sdk';2 3// ═══ Bước 1: Khởi tạo SDK ═══4// apiKey lấy ở Dashboard → Tài khoản → API Key5const sdk = new NestProxySDK({6 apiKey: 'YOUR_API_KEY',7});8 9// ═══ Bước 2: Lấy proxy IP mới ═══10// Truyền vào proxy key (lấy ở Dashboard → Key của tôi)11const proxy = await sdk.getNewIP('your-proxy-key');12console.log(proxy.proxy); // "103.1.2.3:8080" ← IP:Port để dùng13console.log(proxy.province); // "Thành phố Hà Nội"14 15// Muốn lấy IP ở tỉnh cụ thể? Truyền thêm provinceId16// (provinceId = 1 là Hà Nội, xem danh sách đầy đủ bên dưới)17const proxyHN = await sdk.getNewIP('your-proxy-key', 1);18 19// ═══ Bước 3: Đổi IP khi cần ═══20// Bước 3a: Xóa IP cũ21await sdk.removeOldIP('your-proxy-key');22// Bước 3b: Lấy IP mới23const newProxy = await sdk.getNewIP('your-proxy-key');24 25// ═══ Xem IP đang dùng ═══26const current = await sdk.getCurrentIP('your-proxy-key');27console.log(current.proxy); // IP hiện tại28console.log(current.canChangeAt); // Thời điểm sớm nhất được đổi IP29 30// ═══ Các thao tác khác ═══31 32// Lấy bảng giá33const pricing = await sdk.getPricing();34 35// Lấy danh sách 63 tỉnh thành (dùng để chọn vùng)36const provinces = await sdk.getProvinces();37// Tìm theo tên38const filtered = await sdk.getProvinces('Hà Nội');39 40// Xem danh sách key đang có41const keys = await sdk.getKeyList();42 43// Mua key mới (trừ tiền từ số dư tài khoản)44const newKeys = await sdk.buyKey({45 keyType: 'NORMAL', // 'NORMAL' | 'VIP' | 'VIP_1H'46 quantity: 2, // mua 2 key47 duration: 30, // sử dụng 30 ngày48});49 50// Gia hạn key sắp hết hạn51const renewed = await sdk.renewKey({52 proxyKey: 'proxy-key-uuid',53 duration: 7, // thêm 7 ngày54});55 56// Xem thông tin tài khoản + số dư57const user = await sdk.getCurrentUser();58console.log(user.balance); // số dư (VNĐ)59 60// Đổi gift code lấy tiền61const gift = await sdk.redeemGiftCode('GIFT-CODE-ABC');62 63// Xem lịch sử64const ipHistory = await sdk.getIpHistory(); // lịch sử đổi IP65const orders = await sdk.getKeyOrders(); // lịch sử mua key66const deposits = await sdk.getDeposits(); // lịch sử nạp tiền📦 Cài đặt SDK (chạy lệnh này trong terminal dự án của bạn):
$ npm install @nestproxy/sdkĐây là cấu trúc JSON mà API trả về. Bạn sẽ nhận được đúng các trường này khi gọi thành công.
Nhận được khi gọi lấy IP mới hoặc xem IP hiện tại
{
proxy: "103.1.2.3:8080", // ← IP:Port để kết nối
province: "TP Hà Nội", // ← Tỉnh thành của IP
provinceId: 1 // ← ID tỉnh
}Nhận được khi xem chi tiết 1 key proxy
{
id: 1,
proxyKey: "uuid-string", // ← Mã key để kết nối
keyType: "NORMAL", // ← Loại: NORMAL / VIP / VIP_1H
isActive: true, // ← Đang hoạt động?
expiredAt: "2025-04-01", // ← Ngày hết hạn
createdAt: "2025-03-01" // ← Ngày tạo
}Nhận được khi xem thông tin tài khoản
{
id: 1,
userName: "john",
email: "john@mail.com",
balance: 500000, // ← Số dư (VNĐ)
role: "USER",
apiKey: "your-api-key", // ← API Key của bạn
paymentCode: "NP12345" // ← Mã nạp tiền
}Nhận được khi lấy danh sách tỉnh thành
{
id: 1, // ← province_id dùng để chọn vùng
name: "TP Hà Nội", // ← Tên tỉnh thành
level: "Thành phố TW" // ← Cấp hành chính
}Nếu bạn gặp lỗi hoặc cần giúp đỡ khi tích hợp API, liên hệ đội ngũ kỹ thuật qua Zalo — chúng tôi sẽ hỗ trợ tận tình.