Перейти к основному содержанию
Управление сессиями позволяет вам контролировать жизненный цикл IP-адреса вашего прокси. По умолчанию каждый ваш запрос получает новый случайный IP-адрес из нашего пула (ротация на каждый запрос). Однако для многих задач необходимо сохранять один и тот же IP-адрес в течение нескольких запросов. Это называется “закреплённой сессией” (sticky session). Вы управляете этим поведением, добавляя параметры сессии к имени пользователя вашего прокси.

​
Типы сессий

Ротация IP (по умолчанию)

Поведение: вы получаете новый IP-адрес при каждом запросе.
Пример использования: идеально подходит для масштабных задач парсинга, где необходимо максимальное разнообразие IP-адресов, чтобы избежать ограничений скорости и блокировок.
Как использовать: отправляйте запросы с базовым именем пользователя, без параметров сессии.

Фиксированный IP (закреплённая сессия)

Поведение: вы получаете один IP-адрес и можете использовать его повторно в течение определённого периода времени.
Пример использования: необходим для любого многошагового сценария на сайте - например, для входа в систему, добавления товаров в корзину или навигации по постраничным результатам.
Как использовать: добавьте параметр -session к своему имени пользователя.

​
Параметры управления сессией

Эти параметры работают вместе, чтобы дать вам полный контроль над закреплёнными сессиями.

​
Идентификатор сессии (-session)

Это основной параметр для включения закреплённой сессии.
  • Формат: -session-[id]
  • Значение: любая буквенно-цифровая строка по вашему выбору. Эта строка является вашим уникальным идентификатором для сессии.
  • Зависимости: нет.
  • Как это работает: все запросы, отправленные с одним и тем же идентификатором сессии, будут направляться через один и тот же выходной IP на протяжении всей сессии. Чтобы получить новый IP, просто измените ID сессии.
  • Примеры имени пользователя:
    • ...-my_scraper-session-user123 (получает IP A)
    • ...-my_scraper-session-user123 (по-прежнему получает IP A)
    • ...-my_scraper-session-user456 (получает новый IP, IP B)

​
Время сессии (-time)

По умолчанию закреплённая сессия длится 10 минут. Параметр -time позволяет вам изменить эту продолжительность.
  • Формат: -time-[минуты]
  • Значение: целое число.
  • Зависимости: должен использоваться вместе с параметром -session.
  • Пример имени пользователя: ...-my_scraper-session-user123-time-30
  • Результат: закреплённая сессия для user123 будет длиться 30 минут вместо 10 по умолчанию.
  • Случай ошибки: использование -time-30 без -session приведёт к ошибке.
Важное замечание о надёжности сессии: Продолжительность сессии - это запрос, а не 100% гарантия. Из-за динамичной природы резидентных сетей устройство-узел может отключиться в любой момент. Если IP-адрес вашей сессии станет недоступным, наша система автоматически назначит вам новый IP при следующем запросе с тем же идентификатором сессии.

​
Строгий режим (-const)

Этот параметр изменяет поведение шлюза, когда IP-адрес сессии становится недоступным.
  • Формат: -const (это флаг, он не имеет значения).
  • Зависимости: должен использоваться вместе с параметром -session.
  • Поведение по умолчанию (без -const): если IP-адрес вашей сессии становится недоступным, мы автоматически назначаем новый IP для вашей сессии. Это гарантирует, что ваш парсер продолжит работу.
  • Поведение с -const: если IP-адрес вашей сессии становится недоступным, мы не назначаем замену. Вместо этого ваш запрос завершится с ошибкой 502 Bad Gateway и заголовком X-Catproxy-Error: Session IP is offline.
  • Пример использования: используйте этот вариант только в тех случаях, когда ваш рабочий процесс критически зависит от использования одного и того же IP от начала до конца, и вы предпочтете, чтобы процесс завершился ошибкой, а не продолжился с новым IP.
  • Пример имени пользователя: ...-my_scraper-session-user123-time-60-const

​
Какой тип сессии использовать?

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