Обзор интеграции кода

📋 Замечания по доступу

Интеграция кода использует данные подключения к прокси, сгенерированные в панели управления. Перед тем как писать код, убедитесь, что у вас есть:

• Хост
• Порт
• Имя пользователя
• Пароль

Если включён белый список по IP, сначала добавьте в него публичный IP сервера или устройства, на котором выполняется ваш код. В противном случае подключение к прокси будет отклонено.

Параметры имени пользователя

Имя пользователя в коде может быть базовым именем аккаунта либо включать параметры локации, сессии и ротации.

test
test-country-us
test_1-country-us-sessiontime-10
test-country-us-f-1

Основные правила:

• country задаёт выход на уровне страны, например test-country-us.
• sessionid указывается после нижнего подчёркивания в имени аккаунта. В test_1 значение sessionid — 1. Это не параметр вида -sessionid-xxx.
• Разные значения sessionid — это независимые сессии, соответствующие разным IP. Максимальная длина — 32 символа.
• sessiontime задаёт время сохранения сессии. Единица измерения — минуты, поддерживаемый диапазон — от 1 до 120 минут.
• -f-1 меняет IP при каждом запросе. Подходит для парсинга данных, массового доступа и других задач без сохранения состояния.

WARNING

Динамический резидентный IP поддерживает country, state и city. Динамический IP дата-центра и мобильный IP в настоящее время поддерживают только country и не поддерживают таргетинг на уровне штата или города.

Кроме того, для имён аккаунтов динамического IP дата-центра и мобильного IP требуется маркер _dc или _mobile соответственно, размещаемый перед sessionid — например, test_dc-country-us, test_mobile_1-country-us-sessiontime-10. Динамическому резидентному IP маркер не требуется. Приведённые выше примеры показаны для динамического резидентного IP.

Стратегия сессий и ротации

Сценарий	Рекомендуемое имя пользователя
Динамический выход по умолчанию	test
Выход через США	test-country-us
Сохранять один workflow в течение 10 минут	test_1-country-us-sessiontime-10
Запустить два независимых выхода	test_1-country-us-sessiontime-10, test_2-country-us-sessiontime-10
Менять IP при каждом запросе	test-country-us-f-1

Для входа в систему, регистрации, оформления заказа, отправки форм и других непрерывных сценариев используйте фиксированные sessionid и sessiontime. Для парсинга данных, массового доступа, проверок через API и других задач, не требующих сохранения состояния входа, используйте -f-1.

Тестирование запроса

Перед тем как использовать прокси в рабочем коде, проверьте соединение с помощью curl.

SOCKS5 прокси:

curl -x socks5h://username:password@proxy-domain:port http://ip123.in/ip.json

HTTP прокси:

curl -x http://username:password@proxy-domain:port http://ip123.in/ip.json

Если в ответ приходит JSON с данными о выходном IP, стране и локации, подключение к прокси работает корректно.

🔌 Примеры интеграции кода

Выберите язык программирования, чтобы посмотреть подробные примеры:

• Python — пример интеграции прокси на Python
• Go — пример интеграции прокси на Go
• Java — пример интеграции прокси на Java
• PHP — пример интеграции прокси на PHP