Параметры прокси с оплатой за ГБ
Параметры выбора PPG-прокси — это суффиксы, добавляемые к логину прокси. Используйте «Настройка и экспорт» в личном кабинете, чтобы выбрать пул, хаб, протокол, локацию и сессию.
Область подключения#
Одни и те же данные для подключения PPG работают с каждым подходящим хабом и с HTTP или SOCKS5. Выбранный пул определяет маршрутизацию и цену. Гибкий токен выбирает пул через _pool-.... Фиксированный токен использует сохранённый пул, и этот суффикс ему не нужен; суффикс другого пула отклоняется.
UDP#
Пулы с пометкой UDP передают UDP через SOCKS5-эндпоинт. HTTP-прокси передают только TCP. API пулов с оплатой за ГБ сообщает это как udp. UDP может достигать любого порта назначения, кроме нескольких сервисов, которыми часто злоупотребляют, таких как SNMP, NetBIOS, SIP, SSDP и memcached.
Грамматика логина#
Добавьте к базовому логину прокси ноль или более сегментов, разделённых подчёркиванием:
<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles_sid-crawl-42_sttl-600
| Параметр | Синтаксис | Правила |
|---|---|---|
pool |
_pool-<auth-key> |
Обязателен в экспортированных данных для подключения. Ключ пула в нижнем регистре из личного кабинета; не более 80 символов. |
country |
_country-<slug> |
Гео-slug в нижнем регистре, не более 80 символов. uk нормализуется в gb. |
region |
_region-<slug> |
Требует country при использовании в каноническом гео-пути. |
state |
_state-<slug> |
Псевдоним region для совместимости |
city |
_city-<slug> |
Требует и country, и region. |
sid |
_sid-<session-id> |
Буквы, цифры и дефисы после очистки; не менее 3 символов. Используются только первые 15, поэтому ID сессий должны быть уникальны в пределах первых 15 символов. |
sttl |
_sttl-<seconds> |
Значения 1–86400 учитываются. 0 и 86401–999999 сейчас заменяются на 600; семь и более цифр недопустимы. |
Используйте слаги из личного кабинета в нижнем регистре. Для выбора города нужны и country, и region. state — псевдоним region для совместимости; не указывайте оба. Псевдоним страны uk в нижнем регистре нормализуется в gb в этой грамматике логина, в отличие от API бесплатных прокси.
Примеры географии#
# country
<base-username>_pool-residential-kilo_country-us
# region inside a country
<base-username>_pool-residential-kilo_country-us_region-california
# city inside a region
<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles
Используйте варианты географии, показанные в личном кабинете для выбранного пула. Синтаксически допустимый слаг всё равно может быть недоступен в этом пуле.
Недопустимые или неоднозначные примеры:
<base-username>_city-los-angeles
<base-username>_region-california_city-los-angeles
<base-username>_country-us_region-california_state-california
Сессии с фиксированным IP#
sid запрашивает привязку сессии. После очистки ID сессии содержит буквы, цифры и дефисы и должен быть не короче 3 символов. Используются только первые 15 символов, поэтому делайте ID сессий уникальными в пределах первых 15 символов.
<base-username>_pool-residential-kilo_country-de_sid-cart-17_sttl-900
sttl задаёт запрашиваемое время жизни фиксированной сессии в секундах. Значения 1–86400 учитываются. Текущее поведение для совместимости приводит 0 и значения 86401–999999 к 600 секундам; семь и более цифр недопустимы. Указывайте явное допустимое значение и не полагайтесь на запасное поведение.
Ошибки и повторы#
Сбои выбора PPG обычно возвращаются как код ошибки HTTP-прокси 11 с конкретным сообщением. Сбой учёта трафика — код 12. Недостаток средств на балансе — код 13 с HTTP 402; в этом случае нужно проверить или пополнить баланс, а не повторять сетевой запрос.
Наблюдаемые HTTP-заголовки и ограничения SOCKS5 описаны в справочнике ошибок прокси. О сбоях PPG-апстрима см. рекомендации по коду 16.