Hướng Dẫn Đổi IP Tự Động Qua API ProxyHub.vn

API xoay Proxy là giao diện lập trình ứng dụng cho phép người dùng gửi lệnh đổi địa chỉ IP mới hoàn toàn tự động mà không cần đăng nhập vào bảng điều khiển trên website. Khi vận hành các hệ thống nuôi tài khoản số lượng lớn, tạo tài khoản (Reg acc) hoặc cào dữ liệu (Web Scraping), việc tích hợp API xoay Proxy vào phần mềm giúp quy trình làm việc diễn ra liên tục 24/7 và tiết kiệm 90% thời gian thao tác thủ công.

Trong tài liệu hướng dẫn chi tiết dưới đây, đội ngũ kỹ thuật ProxyHub.vn sẽ cung cấp đầy đủ thông số Endpoint, cấu trúc Header, Body cùng các đoạn mã nguồn mẫu (cURL, Python, Node.js, C#) để bạn tích hợp tính năng xoay IP tự động chỉ trong 1 phút!

⚡ Thông số cấu hình nhanh API Xoay Proxy tại ProxyHub.vn:

  • API Endpoint: https://api.proxyhub.vn/api/rotate-ip
  • Phương thức (Method): POST (Định dạng dữ liệu: application/json)
  • Xác thực (Headers): Truyền khóa bảo mật cá nhân qua trường x-api-key: API_KEY_CUA_BAN
  • Tham số gửi đi (Body JSON): Chỉ định cổng cần xoay gồm ip và port của Proxy.

1. Cách Lấy API Key Và Thông Tin Cổng Proxy Trên ProxyHub.vn

Để bắt đầu sử dụng API xoay Proxy, bạn cần chuẩn bị 2 thông số định danh từ tài khoản của mình tại ProxyHub.vn theo 3 bước đơn giản sau:

  1. Bước 1 – Đăng nhập hệ thống: Truy cập vào trang quản trị tài khoản của bạn tại ProxyHub.vn.
  2. Bước 2 – Sao chép mã API Key cá nhân: Vào mục Hồ sơ cá nhân / Cài đặt API để lấy chuỗi mã API Key của bạn. Lưu ý bảo mật tuyệt đối mã này và không chia sẻ cho người lạ.
  3. Bước 3 – Lấy thông số IP và Port của gói Proxy Xoay: Vào mục quản lý dịch vụ Proxy Xoay bạn đang thuê, ghi nhận lại địa chỉ ip (Host/Gateway) và cổng port tương ứng (Ví dụ: IP 103.162.20.88 và Port 50001).

(Nếu bạn chưa phân biệt rõ khi nào nên dùng cơ chế xoay IP tự động và khi nào nên giữ cố định IP, hãy xem thêm bài viết: Khác Biệt Cốt Lõi Giữa Proxy Tĩnh Và Proxy Xoay).

2. Đặc Tả Kỹ Thuật Endpoint API Xoay Proxy (Method, Header, Body)

Hệ thống API xoay Proxy của ProxyHub.vn được thiết kế theo chuẩn RESTful API hiện đại, sử dụng phương thức POST để đảm bảo tính bảo mật cao nhất cho khóa API và thông số cổng mạng của bạn.

2.1. Đường dẫn URL Endpoint & Phương thức

POST https://api.proxyhub.vn/api/rotate-ip

2.2. Cấu hình Request Headers (Bắt buộc)

Trong phần Header của yêu cầu gửi đi, bạn cần khai báo định dạng dữ liệu JSON và đính kèm mã x-api-key của tài khoản:

Tên Trường (Header Key) Giá Trị (Value) Mô Tả Chi Tiết
Content-Type application/json Khai báo dữ liệu gửi lên ở định dạng JSON chuẩn.
x-api-key API Key của USER Mã khóa bảo mật tài khoản của bạn trên ProxyHub.vn.

2.3. Cấu trúc Request Body (JSON Payload)

Trong phần Body của lệnh POST, bạn truyền vào đối tượng JSON chứa địa chỉ ip và port của cổng Proxy cần đổi IP mới:

{
  "ip": "xxx.xxx.xxx.xxx",
  "port": "50001"
}
  • ip (String - Bắt buộc): Địa chỉ IP máy chủ Proxy của bạn (thay xxx.xxx.xxx.xxx bằng IP thực tế trong đơn hàng).
  • port (String - Bắt buộc): Số cổng kết nối của con Proxy bạn muốn thực hiện xoay IP (Ví dụ: "50001").

3. Code Mẫu Tích Hợp API Xoay Proxy (cURL, Python, Node.js)

Để giúp các lập trình viên và người chạy tool tự động hóa tích hợp nhanh nhất, dưới đây là các đoạn code mẫu gọi API xoay Proxy đã được chuẩn hóa. Bạn chỉ cần copy và thay thế thông số thực tế của mình vào:

3.1. Gọi API xoay Proxy bằng lệnh cURL (Terminal / Command Prompt / Bash)

curl -X POST "https://api.proxyhub.vn/api/rotate-ip" \
  -H "Content-Type: application/json" \
  -H "x-api-key: NHAP_API_KEY_CUA_BAN_VAO_DAY" \
  -d '{
    "ip": "xxx.xxx.xxx.xxx",
    "port": "50001"
  }'

3.2. Code Python xoay IP tự động (Thư viện Requests – Dùng cho Selenium / Playwright)

import requests

def rotate_proxy_ip(proxy_ip, proxy_port, api_key):
    url = "https://api.proxyhub.vn/api/rotate-ip"
    
    headers = {
        "Content-Type": "application/json",
        "x-api-key": api_key
    }
    
    payload = {
        "ip": str(proxy_ip),
        "port": str(proxy_port)
    }
    
    try:
        response = requests.post(url, json=payload, headers=headers, timeout=15)
        print("Status Code:", response.status_code)
        print("Response:", response.json())
        return response.json()
    except Exception as e:
        print("Lỗi khi gọi API xoay Proxy:", e)

# Thay thông số thực tế của bạn vào dưới đây để chạy:
API_KEY = "NHAP_API_KEY_CUA_BAN"
PROXY_IP = "xxx.xxx.xxx.xxx"
PROXY_PORT = "50001"

rotate_proxy_ip(PROXY_IP, PROXY_PORT, API_KEY)

3.3. Code JavaScript / Node.js (Fetch API / Axios – Dùng cho Puppeteer)

async function rotateProxy() {
  const url = "https://api.proxyhub.vn/api/rotate-ip";
  
  const headers = {
    "Content-Type": "application/json",
    "x-api-key": "NHAP_API_KEY_CUA_BAN"
  };

  const bodyData = {
    ip: "xxx.xxx.xxx.xxx",
    port: "50001"
  };

  try {
    const response = await fetch(url, {
      method: "POST",
      headers: headers,
      body: JSON.stringify(bodyData)
    });
    
    const result = await response.json();
    console.log("Kết quả xoay IP:", result);
  } catch (error) {
    console.error("Lỗi kết nối API:", error);
  }
}

rotateProxy();

4. Hướng Dẫn Gọi API Xoay Proxy Trên Postman, n8n Và RPA AdsPower

Nếu bạn không viết code mà sử dụng các công cụ tự động hóa kéo thả (No-code / Low-code) như n8n, Make.com, Postman hoặc tính năng RPA trên trình duyệt ẩn danh AdsPower / GPM Login, bạn chỉ cần thiết lập khối HTTP Request theo đúng 4 bước sau:

  1. Bước 1 – Chọn Method và URL: Trong node HTTP Request (hoặc API Request), chọn phương thức là POST và dán đường dẫn https://api.proxyhub.vn/api/rotate-ip vào ô URL.
  2. Bước 2 – Cài đặt phần Headers: Bấm thêm mới một tham số Header với Name là x-api-key và Value là mã API Key của bạn.
  3. Bước 3 – Cài đặt phần Body: Chọn kiểu Body là JSON (Raw) và điền cấu trúc {"ip": "xxx.xxx.xxx.xxx", "port": "50001"}.
  4. Bước 4 – Thêm bước nghỉ (Wait/Delay 3 – 5 giây): Sau lệnh gọi API xoay Proxy, bạn nên thêm một bước nghỉ Wait 3 – 5 giây trong kịch bản RPA trước khi cho trình duyệt tải trang web mới để đảm bảo định tuyến mạng mới đã hoàn tất 100%.
🛠️ Công cụ kiểm tra nhanh sau khi xoay: Để xác nhận cổng Proxy đã đổi sang địa chỉ IP mới thành công và kiểm tra độ trễ Ping thực tế, bạn có thể dán thông số Proxy vào Công Cụ Kiểm Tra Proxy Online miễn phí tại ProxyHub.vn!

5. Bảng Mã Trạng Thái Phản Hồi (Response Codes) Và Lưu Ý Chống Lỗi

Khi phần mềm của bạn gửi yêu cầu tới API xoay Proxy, máy chủ của ProxyHub.vn sẽ trả về phản hồi dưới định dạng JSON kèm mã trạng thái HTTP tiêu chuẩn dưới đây để bạn dễ dàng bắt lỗi (Try/Catch) trong kịch bản tự động:

Mã HTTP Status Ý Nghĩa Trạng Thái Cách Kiểm Tra & Xử Lý Trong Tool
200 OK Xoay IP thành công! Cổng Proxy đã được cấp phát địa chỉ IP mới, sẵn sàng tiếp tục phiên làm việc.
400 Bad Request Thiếu thông số hoặc chưa đủ thời gian chờ (Cooldown) Kiểm tra lại xem đã truyền đúng trường ip và port dạng chuỗi (String) chưa, hoặc chờ hết thời gian giãn cách giữa 2 lần xoay.
401 / 403 Sai hoặc thiếu mã x-api-key Kiểm tra lại khóa x-api-key trong phần Header đã khớp với tài khoản sở hữu con Proxy đó chưa.
404 Not Found Không tìm thấy Proxy hoặc đã hết hạn Kiểm tra lại địa chỉ ip và port xem gói dịch vụ còn hạn sử dụng trên hệ thống không.

6. Giải Đáp 6 Câu Hỏi Thường Gặp (FAQ) Khi Sử Dụng API Xoay Proxy

Câu hỏi 1: Sau khi gọi lệnh API xoay Proxy thành công thì thông số IP:Port:User:Pass gắn trong phần mềm có bị thay đổi không?

Trả lời: Hoàn toàn KHÔNG thay đổi! Thông số kết nối đầu vào (gồm ip Gateway, port, username và password) bạn đã nạp vào trình duyệt ẩn danh hay phần mềm luôn giữ nguyên cố định. Lệnh API xoay Proxy chỉ làm nhiệm vụ thay đổi địa chỉ IP đầu ra (Exit-Node IP) khi đi ra ngoài Internet, nên bạn không bao giờ phải nhập lại Proxy vào tool!

Câu hỏi 2: Tôi có bị giới hạn số lần gọi API xoay IP hoặc giới hạn dung lượng băng thông (GB) trong tháng không?

Trả lời: Tại ProxyHub.vn, các gói Proxy Xoay đều được mở khóa 100% không giới hạn băng thông (Unlimited Bandwidth) và không giới hạn tổng số lượt xoay IP trong suốt chu kỳ thuê. Bạn chỉ cần tuân thủ thời gian giãn cách tối thiểu (Cooldown) giữa 2 lần bấm xoay liên tiếp theo quy định của từng gói.

Câu hỏi 3: Tại sao tôi dùng trình duyệt gõ trực tiếp link https://api.proxyhub.vn/api/rotate-ip lên thanh địa chỉ lại báo lỗi?

Trả lời: Khi bạn dán link trực tiếp lên thanh địa chỉ của trình duyệt web, trình duyệt sẽ gửi yêu cầu theo phương thức GET và không có Header (x-api-key) cũng như Body. Hệ thống của chúng tôi yêu cầu phương thức POST kèm khóa bảo mật, vì vậy bạn hãy gọi qua code (Python, Node.js, cURL), Postman hoặc node HTTP Request trong tool nhé!

Câu hỏi 4: Nếu tôi có 50 cổng Proxy Xoay trong tài khoản, làm sao để xoay đồng loạt cả 50 cổng bằng API?

Trả lời: Vì tất cả các cổng trong cùng một tài khoản dùng chung 1 mã x-api-key, bạn chỉ cần dùng một vòng lặp (Loop) trong code để truyền lần lượt từng cặp ip và port của 50 cổng đó vào phần Body của API là có thể điều khiển xoay độc lập từng cổng theo ý muốn.

Câu hỏi 5: Các gói Proxy Tĩnh (Dân cư Tĩnh, IPv4 Tĩnh) có gọi được API xoay IP này không?

Trả lời: Endpoint /api/rotate-ip được thiết kế riêng cho các gói Proxy Xoay (Rotating Proxy). Đối với các gói Proxy IPv4 Chất Lượng Cao thuộc dòng Tĩnh hoặc Proxy Dân Cư Tĩnh US, địa chỉ IP sẽ được khóa cố định suốt kỳ thuê để đảm bảo độ an toàn cao nhất cho việc nuôi tài khoản dài hạn.

Câu hỏi 6: Nếu gặp lỗi trong quá trình tích hợp API vào tool riêng của tôi thì liên hệ hỗ trợ ở đâu?

Trả lời: Đội ngũ kỹ thuật viên của ProxyHub.vn luôn trực 24/7 qua kênh Telegram và Livechat trên website để hỗ trợ bạn kiểm tra mã phản hồi (Debug) và hướng dẫn tích hợp vào phần mềm hoàn toàn miễn phí!

7. Kết Luận

Tích hợp API xoay Proxy qua phương thức POST chuẩn mực tại ProxyHub.vn giúp bạn tự động hóa hoàn toàn quy trình làm mới địa chỉ IP, vượt qua mọi rào cản giới hạn truy cập (Rate-Limit) và tăng tốc độ vận hành hệ thống MMO gấp nhiều lần.

Hãy sao chép ngay các đoạn mã mẫu phía trên để đưa vào dự án của bạn, hoặc truy cập bảng điều khiển của chúng tôi để khởi tạo thêm các cổng Proxy Xoay không giới hạn băng thông ngay hôm nay!

⚡ Khởi tạo ngay dàn Proxy Dân Cư Xoay & IPv6 Xoay Tự Động Qua API (Sạch 100%, Không Giới Hạn Băng Thông & Lượt Đổi IP) chỉ trong 5 giây tại ProxyHub.vn!