В этой статье мы расскажем о методе, направленном на автоматизацию работы с добавлением IP в Вайтлист вашего пакета или смену ранее привязанного IP. Это особенно полезно в случае, если у вас динамический IP или предполагается работа с прокси с разных, постоянно меняющихся устройств.
Напомним, что IP Вайтлист обязателен для получения доступа к прокси на вашем пакете при использовании IP авторизации.
Для авторизации по логину-паролю, привязывать IP в Вайтлист не обязательно, в этом случае автоматически будет установлен режим Any IP на вашем пакете.
Режим Any IP ослабляет меры безопасности, используемые для защиты вашего пакета, и любой, имеющий логин и пароль, сможет подключиться к вашему пакету. Просим вас добавлять IP в Вайтлист ради безопасности пакета, в этом случае, оба метода авторизации будут работать только лишь с IP из Вайтлиста.
Для работы с данными API методами можно воспользоваться cURL запросами или Postman, импортировав в него документацию.
Мы приведем примеры использования с помощью сURL запросов для Windows 10 и iOS/Linux (инструкция по подключению описана здесь).
В методах используются следующие переменные:
<api-key>- индивидуальный API-ключ, доступный во вкладке "Profile".
<package-key>- логин пакета, в вайтлисте которого необходимо внести изменения.
Получение информации по всем доступным слотам в пакете.
Для Windows 10:
curl --location --request GET "https://partner.api.soax.com/v1/account/package/<package-key>/ip-list" --header "api-key: <api-key>"
Для iOS/Linux:
curl --location --request GET 'https://partner.api.soax.com/v1/account/package/<package-key>/ip-list?=' \--header 'api-key: <api-key>'
В ответе на запрос получаем информацию по каждому из слотов в формате:
IP-адрес в слоте, комментарий к слоту, номер слота.
Обновить IP в доступных слотах.
В этом запросе появляются новые переменные:
<slot_IP>- IP, который нужно закрепить в слоте;<slot_number>- номер изменяемого слота;<slot_name>- название изменяемого слота.
Для Windows 10:
curl --location --request POST "https://partner.api.soax.com/v1/account/package/<package-key>/update-ip?=" --header "api-key: <api-key>" --header "Content-Type: application/json" --data-raw "[{\"ip\": \"<slot_IP>\", \"slot\": <slot_number>,\"comment\": \"<slot_name>\"}]"Для iOS/Linux:
curl --location --request POST 'https://partner.api.soax.com/v1/account/package/<package-key>/update-ip?=' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"ip": "<slot_IP>",
"slot": <slot_number>,
"comment": "<slot_name>"
},
]'
Удалить привязанный IP.
При этом методе слот не удаляется, а остается пустым. Существует два варианта использования:
По уникальному ID слота:
Для Windows 10:
curl --location --request POST "https://partner.api.soax.com/v1/account/package/<package-key>/detach-ip" --header "api-key: <api-key>" --header "Content-Type: application/json" --data-raw "[{\"slot\": <slot_number>}]"Для iOS/Linux:
curl --location --request POST 'https://partner.api.soax.com/v1/account/package/<package-key>/detach-ip' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"slot": <slot_number>
}
]'
По IP адресу:
Для Windows 10:
curl --location --request POST "https://partner.api.soax.com/v1/account/package/<package-key>/detach-ip" --header "api-key: <api-key>" --header "Content-Type: application/json" --data-raw "[{\"ip\": \"<slot_IP>\"}]"Для iOS/Linux:
curl --location --request POST 'https://partner.api.soax.com/v1/account/package/package-key/detach-ip' \
--header 'api-key: api-key' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"ip": "IP address"
}
]'
Если у вас возникнут какие-либо вопросы или трудности во время использования описанных API методов, пожалуйста, свяжитесь с нашей Службой Поддержки в чате или по email на почту [email protected] 👩💻👨💻