HƯỚNG DẪN SỬ DỤNG API

Tích hợp NestProxy API

Tài liệu đầy đủ 15 endpoint API. Hỗ trợ SDK TypeScript/JavaScript và gọi trực tiếp qua HTTP. Tích hợp proxy dân cư trong vài phút.

SDK TypeScript

Cài đặt SDK chỉ 1 dòng lệnh, gọi API type-safe với đầy đủ autocomplete

63 tỉnh thành

Chọn IP theo vùng miền — hỗ trợ đầy đủ 63 tỉnh thành trên toàn quốc

Auth đơn giản

Xác thực bằng API Key qua header — không cần OAuth phức tạp

TẢI XUỐNG

Phần mềm & Tiện ích

Tải xuống phần mềm và tiện ích phù hợp với thiết bị của bạn để bắt đầu sử dụng proxy ngay

Phần mềm quản lý proxy

Proxy Client Window

Phần mềm quản lý proxy với tính năng tạo, quản lý và đổi IP hàng loạt tự động.

Windows
Tải xuống
Tiện ích trình duyệt

Proxy Client Extension

Tiện ích trình duyệt giúp bạn kết nối proxy, lấy IP và đổi IP dễ dàng ngay trên trình duyệt.

ChromeFirefoxEdgeBrave
Tải xuống
Ứng dụng quản lý hệ thống

Proxy Host

Ứng dụng giúp bạn thiết lập và quản lý proxy host dễ dàng trên hệ thống.

Windows
Tải xuống
Ứng dụng kết nối ngược

Back Connect

Ứng dụng hỗ trợ kết nối ngược (Back Connect) xử lý key và đổi proxy hàng loạt.

Windows
Tải xuống
Ứng dụng di động

Proxy Client Android

Ứng dụng Android giúp bạn quản lý proxy, đổi IP và theo dõi trạng thái key ngay trên điện thoại.

Android
Tải xuống
Công cụ điều hướng proxy

Proxifier v3.28

Phần mềm Proxifier giúp điều hướng toàn bộ kết nối mạng qua proxy, hỗ trợ SOCKS5 và HTTP/HTTPS.

Windows
Tải xuống
API REFERENCE

Tài liệu API đầy đủ

13 endpoint — hỗ trợ quản lý proxy, key, tài khoản và lịch sử giao dịch

Xác thực (Authentication)

Các endpoint đánh dấu Auth yêu cầu gửi API Key trong header:

user-api-key: YOUR_API_KEY

Lấy API Key tại Dashboard → Tài khoản. Các endpoint Public không cần xác thực.

GET
/api/client/provinces
Danh sách tỉnh thành Public
search_text?
GET
/api/client/pricing
Bảng giá key Public
domain?
GET
/api/client/proxy/available
Lấy IP mới Public
proxy_key, province_id?
GET
/api/client/proxy/current
Xem IP hiện tại Public
proxy_key
POST
/api/client/proxy/remove
Đổi IP (xóa IP cũ) Public
proxy_key
GET
/api/client/key/detail
Chi tiết 1 key Public
proxy_key
GET
/api/client/key/list
Danh sách key của bạn Auth
POST
/api/client/key/buy
Mua key mới Auth
body: keyType, quantity?, duration?
POST
/api/client/key/renewal
Gia hạn key Auth
body: proxyKey, duration?
POST
/api/client/key/remove
Xóa key Auth
proxy_key
GET
/api/client/user/current
Thông tin tài khoản Auth
POST
/api/client/gift-code/redeem
Đổi Gift Code lấy tiền Auth
body: code
GET
/api/client/ip-history
Lịch sử lấy IP Auth
page?, limit?
GET
/api/client/key-orders
Lịch sử mua/gia hạn key Auth
page?, limit?
GET
/api/client/deposits
Lịch sử nạp tiền Auth
page?, limit?

Code Examples

Chọn cách tích hợp phù hợp với dự án của bạn

typescript — @nestproxy/sdk
1import { NestProxySDK } from '@nestproxy/sdk';
2
3// ═══ Khởi tạo SDK ═══
4const sdk = new NestProxySDK({
5 apiKey: 'YOUR_API_KEY', // Bắt buộc nếu dùng các hàm quản lý Key/User
6 // baseUrl: 'https://nestproxy.com/', // mặc định
7});
8
9// Hoặc khởi tạo không cần apiKey nếu chỉ dùng public endpoints (Provinces, Pricing, Proxy available/current)
10const publicSdk = new NestProxySDK();
11
12// ═══ Lấy danh sách tỉnh thành ═══
13const provinces = await sdk.getProvinces();
14const filtered = await sdk.getProvinces('Hà Nội');
15
16// ═══ Xem bảng giá ═══
17const pricing = await sdk.getPricing();
18
19// ═══ Proxy — Lấy IP mới ═══
20const proxy = await sdk.getNewIP('your-proxy-key');
21// Lấy IP theo tỉnh (provinceId = 1 là Hà Nội)
22const proxyHN = await sdk.getNewIP('your-proxy-key', 1);
23
24// ═══ Proxy — Xem IP hiện tại ═══
25const current = await sdk.getCurrentIP('your-proxy-key');
26console.log(current.proxy); // "103.1.2.3:8080"
27console.log(current.canChangeAt); // "2026-03-31T06:22:00.000Z"
28
29// ═══ Proxy — Đổi IP (xóa IP cũ) ═══
30const removed = await sdk.removeOldIP('your-proxy-key');
31
32// ═══ Quản lý Key ═══
33const keys = await sdk.getKeyList();
34const detail = await sdk.getKeyDetail('proxy-key-uuid');
35const newKeys = await sdk.buyKey({
36 keyType: 'NORMAL', // 'NORMAL' | 'VIP' | 'VIP_1H'
37 quantity: 2,
38 duration: 30, // ngày
39});
40const renewed = await sdk.renewKey({
41 proxyKey: 'proxy-key-uuid',
42 duration: 7,
43});
44const deleted = await sdk.removeKey('proxy-key-uuid');
45
46// ═══ Thông tin tài khoản ═══
47const user = await sdk.getCurrentUser();
48console.log(user.balance);
49
50// ═══ Đổi Gift Code ═══
51const gift = await sdk.redeemGiftCode('GIFT-CODE-ABC');
52
53// ═══ Lịch sử ═══
54const ipHistory = await sdk.getIpHistory();
55const orders = await sdk.getKeyOrders();
56const deposits = await sdk.getDeposits();

Cài đặt SDK:

$ npm install @nestproxy/sdk

Response Types

Cấu trúc dữ liệu trả về từ các endpoint

ProxyInfo

Kết quả khi lấy IP mới hoặc xem IP hiện tại

{
  proxy: "103.1.2.3:8080",
  province: "Thành phố Hà Nội",
  provinceId: 1
}

KeyDetail

Thông tin chi tiết key proxy

{
  id: 1,
  proxyKey: "uuid-string",
  keyType: "NORMAL",
  isActive: true,
  expiredAt: "2025-04-01T...",
  createdAt: "2025-03-01T..."
}

UserInfo

Thông tin tài khoản người dùng

{
  id: 1,
  userName: "john",
  email: "[email protected]",
  balance: 500000,
  role: "USER",
  apiKey: "your-api-key",
  paymentCode: "NP12345"
}

Province

Thông tin tỉnh/thành phố

{
  id: 1,
  name: "Thành phố Hà Nội",
  level: "Thành phố Trung ương"
}

Bạn cần hỗ trợ thêm?

Đội ngũ hỗ trợ kỹ thuật luôn sẵn sàng giúp bạn tích hợp API và cài đặt phần mềm

Liên hệ hỗ trợ (Zalo)