API xoay IP proxy di động: thay đổi IP qua link hoặc gọi API

Liên kết xoay IP hoạt động thế nào?

Liên kết xoay là một URL đơn giản với ID port của bạn (trông như mob_2v8k1q; khu vực khách hàng hiển thị liên kết sẵn có của từng port) và khóa API. Mở liên kết này trong trình duyệt, bookmark hoặc script sẽ yêu cầu modem ngắt kết nối với nhà mạng và kết nối lại. Nhà mạng sau đó sẽ cấp một địa chỉ IP, thường là IP khác.

Thêm &format=text để chỉ nhận IP mới ở dạng văn bản thuần, rất tiện cho script shell. Xử lý liên kết này như mật khẩu: ai có liên kết có thể xoay port của bạn, và cùng khóa này gửi trong lệnh API cũng có thể thay đổi cài đặt port, thêm sub-user hoặc danh sách IP cho phép. Hãy tạo khóa riêng chỉ cho liên kết xoay IP, giữ liên kết tránh chia sẻ trong tài liệu hay xem trước chat, và thu hồi khóa trong khu vực khách hàng nếu bị lộ.

# Replace {port} with your port ID (e.g. mob_2v8k1q, not 7777) and API_KEY with your key
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY"

# Plain-text answer: just the new IP
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY&format=text"

Tôi xoay IP bằng script với REST API thế nào?

Scripts nên dùng POST với khóa đặt trong header Authorization để khóa không bị lưu trong log máy chủ hay lịch sử trình duyệt. Phản hồi trả về cho bạn IP mới và thời điểm được phép xoay tiếp theo.

curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \
  -H "Authorization: Bearer API_KEY"

{
  "ip": "203.0.113.24",
  "previousIp": "198.51.100.7",
  "rotatedAt": "2026-10-13T09:41:07Z",
  "nextRotationAvailableAt": "2026-10-13T09:41:37Z"
}

Điều gì xảy ra nếu tôi xoay quá nhanh?

Một port chỉ cho phép xoay thủ công tối đa 1 lần mỗi 30 giây. Yêu cầu gọi trước thời gian đó trả về HTTP 429 với lỗi rotation_too_soon và header Retry-After cung cấp thời gian đợi tính bằng giây. Không có gì hỏng: port giữ IP hiện tại.

Xoay nhanh nhất có thể thường không hiệu quả. Mỗi lần kết nối lại port không truyền tải dữ liệu, và nhà mạng có thể cấp lại IP cũ. Hướng dẫn chiến lược xoay IP gợi ý khoảng thời gian phù hợp cho từng nhiệm vụ.

HTTP/1.1 429 Too Many Requests
Retry-After: 22
Content-Type: application/json

{
  "error": {
    "code": "rotation_too_soon",
    "message": "Next rotation available in 22 seconds",
    "details": { "retryAfter": 22 },
    "requestId": "req_2b7c11"
  }
}

Làm thế nào để tôi thiết lập xoay tự động theo bộ hẹn giờ?

Đặt chế độ xoay port thành interval và chọn số phút từ 2 đến 1.440 (từ 2 phút đến 24 giờ). Bộ hẹn giờ sẽ xoay port tự động mà không cần bạn gọi. Chuyển về manual để dừng. Bạn cũng có thể thiết lập bộ hẹn giờ từ khu vực khách hàng.

curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "interval", "intervalMinutes": 10}}'

# back to manual rotation
curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "manual", "intervalMinutes": null}}'

Tôi xoay IP trong Python hoặc Node.js thế nào?

Cả hai ví dụ đều xoay port và in ra IP mới; ví dụ Python sau đó gửi một yêu cầu qua port. Hướng dẫn Python có thêm chức năng thử lại và trợ giúp xoay IP.

import requests

API = "https://cellmast.com/api/v1"
KEY = "API_KEY"
PORT_ID = "PORT_ID"
PROXY = "http://USERNAME:[email protected]:7777"

r = requests.post(f"{API}/mobile/{PORT_ID}/rotate",
                  headers={"Authorization": f"Bearer {KEY}"}, timeout=60)
if r.status_code == 429:
    print("too soon, retry after", r.headers.get("Retry-After"), "s")
else:
    r.raise_for_status()
    print("new IP:", r.json()["ip"])

print(requests.get("https://api.ipify.org",
                   proxies={"http": PROXY, "https": PROXY}, timeout=30).text)

// save as rotate.mjs (ES module), then: node rotate.mjs
const API = "https://cellmast.com/api/v1";
const res = await fetch(`${API}/mobile/PORT_ID/rotate`, {
  method: "POST",
  headers: { Authorization: "Bearer API_KEY" },
  signal: AbortSignal.timeout(60000),
});
if (res.status === 429) {
  console.log("retry after", res.headers.get("retry-after"), "s");
} else if (!res.ok) {
  throw new Error(`HTTP ${res.status}`);
} else {
  const { ip, previousIp } = await res.json();
  console.log(previousIp, "->", ip);
}

Tôi có thể chuyển port sang nhà mạng, thành phố hoặc quốc gia khác không?

Liên hệ hỗ trợ. Cần quốc gia khác? Hỏi bộ phận hỗ trợ: nếu có cổng còn hàng ở đó, chúng tôi chuyển số ngày còn lại của bạn sang và hoàn tất chênh lệch giá qua số dư (mỗi kỳ thanh toán được chuyển 1 lần). Điều này cũng áp dụng khi chuyển nhà mạng hoặc thành phố trong cùng quốc gia. Sau khi chuyển, host, port và mật khẩu có thể thay đổi: xem lại trong khu vực khách hàng.

Tôi có thể xem các IP từng dùng của port không?

Có. GET /api/v1/mobile/{portId}/ip-history liệt kê các địa chỉ đã được cấp cho port cùng thời gian sử dụng. Dùng để kiểm tra các lần xoay có thực sự tạo địa chỉ mới, đối chiếu với log riêng, hoặc xác nhận từng địa chỉ thuộc về nhà mạng bạn chọn. GET /api/v1/mobile/{portId}/usage hiển thị thông tin lưu lượng từng ngày; dữ liệu trên port độc quyền không giới hạn.

Pool di động xoay theo GB có cần API này không?

Không. pool di động xoay IP tự động thay đổi IP: Mỗi kết nối mới được cấp IP từ pool, thường khác IP trước; để nhận IP mới cho mỗi yêu cầu, gửi một yêu cầu trên mỗi kết nối (tắt keep-alive). Bạn kiểm soát nó bằng tên đăng nhập, ví dụ USERNAME-country-us-session-abc123-ttl-15 cho session dính IP 15 phút. API xoay IP dùng cho port độc quyền, nơi một modem thuộc quyền bạn và bạn quyết định thời điểm đổi IP.