У цьому посібнику показано, як замінити проблемний 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 — список ваших проксі