Доступ по белому списку API

Помимо аутентификации по имени пользователя/паролю, Динамический резидентный IP, Динамический IP дата-центра и Мобильный IP поддерживают доступ по белому списку API: добавьте публичный IP вашего локального устройства в белый список, затем получите список записей IP:port через API и используйте их напрямую — без имени пользователя или пароля.

Это подходит для сред с фиксированным выходным IP (серверы, стационарная офисная сеть) или для случаев, когда настраивать учётные данные в каждом инструменте неудобно.

💡 Отличие от «Белого списка аккаунта»

• Доступ по белому списку API (эта страница): способ использования прокси без учётных данных — устройства из белого списка получают IP и используют их напрямую.
• Белый список аккаунта: ограничение безопасности, определяющее, каким IP разрешено подключаться с именем пользователя и паролем аккаунта, без изменения способа использования.

Сравнение с именем пользователя/паролем

	Имя пользователя/пароль	Доступ по белому списку
Аутентификация	Имя пользователя + пароль	Локальный публичный IP в белом списке, без учётных данных
Способ использования	Фиксированный шлюз + параметризованное имя пользователя	Получение конкретных записей IP:port и использование их напрямую
Регион / продолжительность	Записывается в имя пользователя	Задаётся через параметры API получения
Лучше всего для	Несколько аккаунтов, детальное управление сессиями	Среды с фиксированным выходом, массовое получение IP

Шаги

1. Откройте страницу настройки нужной сети: Динамический резидентный IP, Динамический IP дата-центра или Мобильный IP.
2. В разделе Настройка прокси IP выберите Доступ по белому списку.
3. Добавьте публичный IP устройства, которое будет использовать прокси, в белый список («Добавить в белый список» на странице настройки или «Белый список API» в левом меню). IP, не входящие в белый список, отклоняются.
4. Задайте регион, продолжительность IP, протокол (SOCKS5 / HTTP), формат вывода и количество на выходе.
5. Нажмите Сгенерировать, получите набор записей IP:port и используйте их напрямую в вашем инструменте или коде — без учётных данных.

TIP

При доступе по белому списку каждая полученная запись IP:port — это готовый к использованию прокси. Параметризованное имя пользователя не требуется; регион и продолжительность задаются через параметры API получения.

API получения

Панель «Аутентификация по белому списку» на странице настройки генерирует ссылку для получения за вас — просто скопируйте её. Ссылка выглядит так:

https://api2.rola.vip/extract?count=10&api_key=YOUR_API_KEY&proxy_type=residential&format=text&country=&state=&city=&time=10

Параметры

Параметр	Описание	Пример
count	Количество IP для получения («количество на выходе»)	count=10
api_key	Ваш API-ключ из консоли	api_key=YOUR_API_KEY
proxy_type	Тип сети: Динамический резидентный IP — residential, Динамический IP дата-центра — datacenter, Мобильный IP — mobile	proxy_type=residential
format	Формат вывода, например text	format=text
country / state / city	Параметры региона; оставьте пустыми для любого варианта. state и city — только для Динамического резидентного IP	country=us
time	Продолжительность IP в минутах, 1-120	time=10

TIP

proxy_type определяется выбранной сетью и заполняется консолью автоматически — полагайтесь на ссылку, сгенерированную консолью. Параметры региона и продолжительности (country/state/city/time) соответствуют тем, что записываются в имя пользователя при аутентификации по имени пользователя/паролю.

Использование полученных IP

При format=text результат содержит по одной записи IP:port на строку:

1.2.3.4:2000
5.6.7.8:2000

Каждая запись — это готовый к использованию прокси (устройство уже находится в белом списке, поэтому учётные данные не нужны):

curl -x socks5h://1.2.3.4:2000 http://ip123.in/ip.json

Возвращённый JSON содержит выходной IP и его местоположение, подтверждая, что прокси работает.

О полученном IP

Каждая полученная запись IP:port — это один из наших релейных (транзитных) серверных адресов, а не конечный выходной IP. Как только вы фактически отправляете через него запрос, выходом становится IP из выбранного вами региона — выполните команду проверки выше, чтобы увидеть реальный выходной IP и его местоположение.

WARNING

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