1. Phân biệt gói Proxy IPv4 tĩnh và các gói Proxy hỗ trợ xoay IP
Trong vận hành đa tài khoản thương mại điện tử hoặc trình duyệt tự động hóa, nguyên tắc cốt lõi là giữ cố định một địa chỉ IPv4 suốt phiên làm việc (Sticky Static IP). Gói Proxy IPv4 tĩnh Việt Nam (10.000₫/tháng hoặc 429₫/ngày) có chính sách ip_change_policy: "disabled", giữ nguyên IP suốt chu kỳ và chỉ cập nhật tài khoản/mật khẩu hoặc dải IP cho phép.
Ngược lại, điểm cuối /proxy/rotations chỉ áp dụng cho các dòng sản phẩm Proxy cấu hình cho phép đổi IP (ip_change_policy != "disabled"). Khi worker thu thập dữ liệu gặp mã HTTP 429 trên gói hỗ trợ xoay, kịch bản có thể gọi REST API v1 để kiểm tra báo phí và kích hoạt cấp địa chỉ mới.
2. Cú pháp gọi điểm cuối cập nhật allowed_cidrs và xoay IP chuẩn OpenAPI v1
Khác với các đường dẫn truyền khóa trên URL dễ lộ trong nhật ký truy cập, Cloud247 API v1 xác thực qua Bearer Header (phân quyền services:control) và bắt buộc truyền Idempotency-Key cho mọi lệnh thay đổi cấu hình hoặc xoay IP:
# 1. Cập nhật tài khoản & dải CIDR IP cho phép (bỏ qua new_password nếu giữ mật khẩu cũ)
curl -s -X POST "https://api.cloud247.vn/v1/services/2048/proxy/access-configurations" \
-H "Authorization: Bearer $CLOUD247_API_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: acl-2048-$(date +%s)" \
-d '{
"username": "pxu_worker01",
"allowed_cidrs": ["103.82.24.86/32"]
}'
# 2. Kiểm tra báo phí xoay IP (theo tiền tệ gốc của dịch vụ; chỉ dành cho gói có ip_change_policy != "disabled")
curl -s -H "Authorization: Bearer $CLOUD247_API_TOKEN" \
-H "Accept: application/json" \
"https://api.cloud247.vn/v1/services/2048/proxy/rotations/quote"
# 3. Thực thi xoay IP: gửi JSON {} khi miễn phí hoặc {"accepted_quote":"<token>"} khi có phí
curl -s -X POST "https://api.cloud247.vn/v1/services/2048/proxy/rotations" \
-H "Authorization: Bearer $CLOUD247_API_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: rot-2048-$(date +%s)" \
-d '{}' 3. Lưu ý nhịp chờ (Cooldown) khi luân chuyển địa chỉ
Sau khi kích hoạt lệnh xoay IP, hãy thiết lập khoảng nghỉ 3–5 giây trong worker trước khi mở kết nối mới để các phiên TCP cũ kết thúc gọn gàng, tránh đứt gãy luồng dữ liệu đang tải dở.