В этом руководстве показано, как заменить проблемный IP на новый. Запросить замену IP для одного прокси можно раз в сутки. Обработка может занять некоторое время.
Каждый запрос использует ваш персональный API-ключ из личного кабинета (как получить API-ключ). В примерах ниже замените YOUR_API_KEY на свой ключ. Чтобы оплатить с баланса аккаунта, используйте paymentId = 1.
Шаг 1 — Найдите прокси для замены
Получите список активных прокси и скопируйте id каждого, который хотите заменить. Запомните тип прокси.
Эндпоинт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Ответ
{
"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": []
}
Шаг 2 — Запросите замену
Отправьте запрос на замену, указав ids прокси, type (причину замены) и необязательный комментарий. В ответе возвращаются новые IP.
Эндпоинт
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Тело запроса
Имя | Тип | Описание |
ids | Number / Array | Один ID или массив ID в |
type | String | Причина замены — см. допустимые значения ниже. |
comment (необязательный) | String | Необязательный комментарий к запросу. |
Допустимые значения type: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM.
Пример
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Ответ
{
"status": "success",
"data": {
"ok": {
"ips": [ "31.6.33.97" ],
"msg": "Replacement request submitted"
}
},
"errors": []
}
Полная документация API
Retrieve active proxy — список ваших прокси