Підключення та зміна 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`