Hướng dẫn này cho biết cách thay một IP gặp sự cố bằng IP mới. Bạn có thể yêu cầu thay IP cho một proxy mỗi ngày một lần. Việc xử lý có thể mất chút thời gian.
Mỗi yêu cầu sử dụng khóa API cá nhân của bạn từ bảng điều khiển tài khoản (cách lấy khóa API). Trong các ví dụ dưới đây, hãy thay YOUR_API_KEY bằng khóa của bạn. Để thanh toán bằng số dư tài khoản, dùng paymentId = 1.
Bước 1 — Tìm các proxy cần thay
Liệt kê các proxy đang hoạt động và sao chép id của mỗi proxy bạn muốn thay. Ghi lại loại proxy.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Phản hồi
{
"status": "success",
"data": {
"items": [
{ "id": "0678564", "ip": "31.6.33.97", "country_alpha3": "BEL", "status_type": "ACTIVE", "can_prolong": true, "date_end": "23.07.2024" }
]
},
"errors": []
}
Bước 2 — Yêu cầu thay thế
Gửi yêu cầu thay thế với ids proxy, type (lý do thay) và một bình luận tùy chọn. Phản hồi trả về các IP mới.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Nội dung yêu cầu
Tên | Loại | Mô tả |
ids | Number / Array | Một ID hoặc mảng ID trong |
type | String | Lý do thay thế — xem các giá trị hợp lệ bên dưới. |
comment (tùy chọn) | String | Bình luận tùy chọn kèm theo yêu cầu. |
Các giá trị type hợp lệ: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM.
Ví dụ
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Phản hồi
{
"status": "success",
"data": {
"ok": {
"ips": [ "31.6.33.97" ],
"msg": "Replacement request submitted"
}
},
"errors": []
}
Tài liệu API đầy đủ
Retrieve active proxy — liệt kê proxy của bạn