# Синтаксис параметров username

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

## Структура

```
{логин}-pool-flow[-region-{код_страны}][-state-{штат}][-city-{город}][-asn-{ASN}][-sid-{8_случайных_символов}-ttl-{минуты}]
```

Слева направо: основная часть логина → идентификатор пула (фиксированный `-pool-flow`) → параметры геотаргетинга → параметры сессии. **Порядок фиксированный, менять его нельзя.**

## Описание параметров

| Параметр | Формат | Описание |
| --- | --- | --- |
| `-pool-flow` | фиксированное значение | идентификатор пула динамических резидентных прокси; в режиме логина и пароля обязателен |
| `-region-{CC}` | двухбуквенный код ISO | таргетинг по стране, например `US`, `GB`, `JP`, `AE`; бесплатно во всех сценариях |
| `-state-{State}` | название штата/региона | используется вместе с `region`, например `California` |
| `-city-{city}` | город: строчными, без пробелов | **только вместе со `state`**, например `losangeles`, `newyork` |
| `-asn-{ASN}` | `AS` + число | таргетинг по ASN (сети оператора), например `AS15802`; **несовместим со `state`/`city`**, сочетается только с `region` |
| `-sid-{seed}` | 8 случайных букв и цифр | идентификатор липкой сессии: один и тот же `sid` переиспользует один IP; смена `sid` — смена IP |
| `-ttl-{n}` | целое число, 1–120 | время удержания IP липкой сессии в минутах; идёт в паре с `sid` |

## Правила сочетания

* Только ротация, без таргетинга: `USERNAME-pool-flow`
* Таргетинг уточняется поэтапно: region → region+state → region+state+city
* Таргетинг по ASN нельзя сочетать со state/city
* Параметры липкой сессии всегда стоят в самом конце
* Без `sid`/`ttl` действует поведение по умолчанию: **новый IP на каждый запрос**

## Полный набор примеров

```bash
# 1. Случайный IP по всему миру, ротация на каждый запрос
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow:PASSWORD" https://ipinfo.io

# 2. Конкретная страна (США)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io

# 3. До уровня штата (Калифорния, США)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California:PASSWORD" https://ipinfo.io

# 4. До уровня города (Лос-Анджелес, Калифорния, США)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles:PASSWORD" https://ipinfo.io

# 5. Таргетинг по ASN (ОАЭ, AS15802)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-AE-asn-AS15802:PASSWORD" https://ipinfo.io

# 6. Страна + липкая сессия (тот же IP из США удерживается 30 минут)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io

# 7. Таргетинг до города + липкая сессия
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io
```

> Не уверены, как собрать строку? На странице «Настройки прокси» личного кабинета есть визуальный генератор: выберите страну/штат/город/тип сессии — страница в реальном времени соберёт полный username, останется его скопировать. Там же можно посмотреть список поддерживаемых стран и городов.

## Типичные ошибки

| Симптом | Причина | Решение |
| --- | --- | --- |
| Ошибка аутентификации (407) | опечатка в username или пропущен `-pool-flow` | сверьтесь с генератором в личном кабинете |
| Таргетинг по городу не срабатывает | `city` указан без `state` | добавьте `-state-{штат}` |
| Таргетинг по ASN не срабатывает | смешан со `state`/`city` | ASN сочетается только с `region` |
| IP постоянно меняется | не используется липкая сессия | добавьте `-sid-{8_символов}-ttl-{минуты}` |