Hướng Dẫn Tích Hợp Rotating Proxy API Với Python & Node.js (2026)

1. Decision Matrix: Nên chọn cách Rotate IP nào?

2. Authentication Best Practice: Bảo mật API Key

Mặc dù hệ thống hỗ trợ Query String, 1IP.VN khuyến nghị bạn truyền mã qua Authorization Header để tránh rò rỉ trong log server. Tham khảo tiêu chuẩn tại MDN HTTP Status.

3. Python Production-grade Snippet (Retry & Backoff)

Để hệ thống không bị crash khi API timeout, bạn cần xử lý exception cụ thể và tích hợp raise_for_status():

import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

API_URL = "https://api.1ip.vn/v1/rotate"
HEADERS = {"X-API-Key": "YOUR_SECURE_TOKEN"}

def get_rotate_session():
    session = requests.Session()
    retry = Retry(total=3, backoff_factor=1, status_forcelist=[429, 500, 502, 503, 504])
    session.mount('https://', HTTPAdapter(max_retries=retry))
    return session

def rotate_ip():
    session = get_rotate_session()
    try:
        response = session.get(API_URL, headers=HEADERS, timeout=10)
        response.raise_for_status() # Kiểm tra lỗi 4xx, 5xx
        return response.json()
    except requests.exceptions.Timeout:
        print("API Timeout - Check hạ tầng mạng")
    except requests.exceptions.HTTPError as e:
        print(f"Lỗi HTTP: {e.response.status_code}")

    

4. Cấu trúc JSON Response mẫu từ 1IP.VN

Một request thành công sẽ trả về payload định dạng chuẩn, giúp bạn dễ dàng parse dữ liệu:

{
  "status": "success",
  "data": {
    "proxy_address": "103.xxx.xxx.xxx:8080",
    "new_ip": "14.xxx.xxx.xxx",
    "cooldown_remaining": 5,
    "asn": "AS15889 (Viettel)"
  }
}
    

5. Xử lý lỗi: 401, 408, 429 và DNS Failure

• 401 Unauthorized: API Key sai hoặc bị vô hiệu hóa. Kiểm tra Dashboard 1IP.VN.
• 429 Too Many Requests: Bạn đang gọi API quá 1 request/5s. Hãy implement backoff logic.
• 408 Timeout / DNS Failure: Thường do firewall của server client chặn request. Hãy whitelist dải IP của 1IP.VN.

6. FAQ - Giải đáp về API Proxy Xoay