Подключение и смена IP

Первые разделы - про Residential. Фиксированные адреса подключаются иначе: отдельный раздел ниже.

Строка подключения

Из ответа POST /api/v1/packages/{id}/proxies приходят host, port, username, password.

Логин - готовая строка: таргетинг и режим закодированы в нём, собирать его самостоятельно нельзя.

Порт кодирует режим и протокол, менять его нельзя.

residential.ipv.rent:10000:USERNAME:PASSWORD          # антидетект-браузеры, прокси-менеджеры
http://USERNAME:[email protected]:10000   # curl, requests, Node, Go
socks5://USERNAME:[email protected]:12000

curl -x 'http://USERNAME:[email protected]:10000' https://api.ipify.org

Режимы и протоколы

Режим	Поведение
`rotating`	новый адрес на каждое подключение
`sticky`	адрес держится `ttl_minutes`: 3..1440, по умолчанию 60

Порт каждой пары (режим, протокол) приходит в connection_options карточки пакета:

Режим	HTTP	SOCKS5
`rotating`	9000	11000
`sticky`	10000	12000

Почтовые протоколы (SMTP, IMAP, POP3) и UDP не поддерживаются.

Таргетинг

{
  "count": 10,
  "geo": {
    "country": "us",
    "state": "california",
    "city": "los angeles"
  }
}

Значения - коды из гео-каталога.

Уровни опциональны: без geo - глобальный пул.
state, city и asn требуют country.
Ниже страны таргетинг выполняется по возможности: если в запрошенном регионе, городе или у оператора нет свободных адресов, выход даётся из другой локации той же страны.

Значение вне каталога, неизвестный ключ или сужение без страны - 422 invalid_targeting с field и value.

Смена IP

В режиме rotating адрес меняется сам.

У каждой sticky-строки есть своя ссылка rotation_url: GET по ней освобождает текущий адрес, следующее подключение получит другой. Авторизация не нужна.

curl -s https://ipv.rent/r/9f3c1e...

HTTP	`status`	Значение
200	`ok`	адрес освобождён
200	`not_in_use`	активной сессии нет; следующее подключение всё равно даст новый адрес
200	`unconfirmed`	запрос отправлен, подтверждения нет
404	`not_found`	ссылка не действует
410	`expired`	ресурс ссылки истёк; для пакетов трафика не возникает
429	`rate_limited`	слишком часто
503	`error`	сменить адрес не удалось

Лимиты: 20 запросов в минуту на адрес, 120 на пакет, 300 на IP вызывающего. Отозвать одну ссылку нельзя - POST /api/v1/packages/{id}/rotation-secret обнуляет все сразу.

Фиксированные адреса

Пакет IPv4 - готовый список адресов. Строки собирать не нужно: всё есть в карточке GET /api/v1/packages/{id}.

Что	Где взять
адреса	`addresses[].host`
порт HTTP	`addresses[].port_http`
порт SOCKS5	`addresses[].port_socks`
логин и пароль	`credentials` - один на все адреса пакета

198.51.100.11:10010:USERNAME:PASSWORD             # антидетект-браузеры, менеджеры прокси
http://USERNAME:[email protected]:10010      # curl, requests, Node, Go
socks5://USERNAME:[email protected]:10011

curl -x 'http://USERNAME:[email protected]:10010' https://api.ipify.org

Выходной адрес - сам адрес из списка, он не меняется на протяжении всего срока.
UDP работает через SOCKS5 - для игр, звонков и сервисов на QUIC.
Таргетинга и ссылок смены IP нет: страна и локация выбираются при покупке.
Получить новые адреса можно заменой - всех адресов пакета сразу, раз в 30 дней.
Почтовые протоколы (SMTP, IMAP, POP3) не поддерживаются.

Если не работает

Симптом	Причина
отказ аутентификации после сборки набора	пароль пакета перевыпущен
перестало работать у всех воркеров сразу	объём израсходован, проверьте `traffic.left_gb`
адрес не из запрошенного гео	в запрошенной локации нет свободных адресов, выдана другая локация той же страны; такие страны гео-каталог помечает `pool: thin` - возьмите уровень выше
422 `package_unavailable` при сборе набора	пакет ещё не выдан (дождитесь `status: active`), `ttl_minutes` вне 3..1440, либо режим или протокол пакетом не поддерживается
фиксированные адреса не отвечают сразу после покупки	пакет выдаётся до 2 минут
фиксированные адреса перестали отвечать все сразу	вышел срок: `status: expired`, продлите пакет
отказ аутентификации на фиксированных адресах	пароль перевыпущен, либо пакет продлён после окончания срока и выдан новый пароль - возьмите `credentials` из карточки
старые фиксированные адреса не работают	адреса заменены: `replacement.state: done`, новые - в `addresses`