Параметры сессии

Возвращает словарь типов ротации, длительностей сессий и IP-фильтров, поддерживаемых сетью, вместе с суффиксом имени пользователя, которому соответствует каждый из них. Используйте его вместе с гео-endpoint'ами для построения имени пользователя прокси (см. Грамматика имени пользователя).

Это статический каталог — он не зависит от вашей подписки.

Получить параметры сессии

Endpoint

GET /api/v2/rotating-proxies/session-options/

Запрос

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v2/rotating-proxies/session-options/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Ответ

{
  "protocols": [
    { "value": "http", "label": "HTTP(S)", "port_field": "proxy_port" },
    { "value": "socks5", "label": "SOCKS5", "port_field": "proxy_port_socks5" }
  ],
  "session_durations": [
    { "value": "rotating", "label": "Rotating (new IP every request)", "suffix": null },
    { "value": "5m", "label": "Sticky 5 minutes", "suffix": "s-<id>-ttl-5m" },
    { "value": "10m", "label": "Sticky 10 minutes", "suffix": "s-<id>-ttl-10m" },
    { "value": "15m", "label": "Sticky 15 minutes", "suffix": "s-<id>-ttl-15m" },
    { "value": "30m", "label": "Sticky 30 minutes", "suffix": "s-<id>-ttl-30m" },
    { "value": "custom", "label": "Sticky custom minutes", "suffix": "s-<id>-ttl-<minutes>m" }
  ],
  "ip_filters": [
    { "value": "max-size-security", "label": "Max pool size", "suffix": null },
    { "value": "max-speed-security", "label": "Max speed", "suffix": "filter-speed" },
    { "value": "quality-security", "label": "Quality (IQS)", "suffix": "filter-iqs" },
    { "value": "speed-quality-security", "label": "Speed + Quality (IQS)", "suffix": "filter-speed+iqs" }
  ],
  "username_grammar": {
    "order": ["base_login", "country", "region", "city", "zip", "isp", "session", "ttl", "filter"],
    "separator": "-",
    "session_id_length": 8,
    "session_id_alphabet": "A-Za-z0-9",
    "example": "user1-{country_suffix}-s-Ab3xK9pQ-ttl-5m-filter-iqs"
  }
}

Поля ответа

Поле	Тип	Описание
protocols	array	Поддерживаемые протоколы. port_field указывает поле GET /subscription/, в котором хранится соответствующий порт
session_durations	array	Пресеты ротации / sticky-сессий и шаблон их суффикса имени пользователя
ip_filters	array	Фильтры качества IP и их суффикс имени пользователя
username_grammar	object	Справка о том, как собирать имя пользователя

Модель ротации и сессий

value	Поведение	Добавляемый суффикс
rotating	Новый IP используется при каждом запросе	(нет)
5m / 10m / 15m / 30m	Один и тот же IP удерживается заданную длительность	s-<id>-ttl-<duration>
custom	Один и тот же IP удерживается произвольное число минут	s-<id>-ttl-<minutes>m

Где <id> — случайная 8-символьная строка из алфавита A-Za-z0-9, которую вы генерируете для каждой сессии. Повторное использование того же <id> сохраняет тот же исходящий IP (пока не истечет TTL); новый <id> начинает новую sticky-сессию.

IP-фильтры

value	Значение	Суффикс
max-size-security	Наибольший пул IP (по умолчанию)	(нет)
max-speed-security	Приоритет самых быстрых IP	filter-speed
quality-security	Приоритет высокого показателя качества IP (IQS)	filter-iqs
speed-quality-security	Баланс скорости и качества	filter-speed+iqs

Пример

Таргетинг на США (suffix страны = us), 5-минутная sticky-сессия и фильтр качества:

real_login           = u12ab
session id           = Ab3xK9pQ
final username       = u12ab-us-s-Ab3xK9pQ-ttl-5m-filter-iqs