# Все требования к выходному узлу указываются в логине.

Страна, штат США, город, провайдер, идентификатор и срок действия сессии. Шесть параметров в любом порядке на обоих общих шлюзах.


## Синтаксис

Начните с логина, затем добавьте пары `-key-value`. Ключи и значения записываются в нижнем регистре; порядок не имеет значения; пароль остаётся прежним. Если параметры не указаны, выходной узел выбирается в любой стране и меняется при каждом подключении.

```text
USER-cc-us-state-tx-city-austin-sid-a1b2c3-ttl-30m:PASS
│    │     │        │           │          │
│    │     │        │           │          └─ закрепить на 30 минут
│    │     │        │           └─ идентификатор сессии: тот же ID — тот же IP
│    │     │        └─ город (только буквы и цифры)
│    │     └─ штат США (только для Соединённых Штатов)
│    └─ страна, код ISO 3166-1 alpha-2
└─ ваш логин
```


## Параметры

| Параметр | Значения | Назначение |
| --- | --- | --- |
| -cc- | Двухбуквенный код страны: `us`, `de`, `br`, `jp` | Выходной узел в этой стране. Резидентские прокси доступны в 199 странах; мобильный пул охватывает страны, перечисленные при оформлении заказа. |
| -state- | Код штата США: `tx`, `ca`, `ny` | Выходной узел в этом штате. Требует `-cc-us`; недоступен для других стран. |
| -city- | Название города в нижнем регистре, только буквы и цифры: `newyork`, `berlin`, `saopaulo` | Выходной узел в этом городе. Требует `-cc-`. На странице каждой [страны](https://hodlproxy.com/ru/locations) перечислены доступные города с точными значениями. |
| -asn- | Номер автономной системы без префикса `AS`: `7922`, `3320` | Выходной узел, анонсируемый этим провайдером. Сочетайте с `-cc-`. В мобильном пуле так выбирается оператор. |
| -sid- | Буквы и цифры, до 32 символов: `a1b2c3`, `job42` | Закреплённая сессия. Запросы с одним ID используют один выходной узел, пока не истечёт срок действия или устройство не отключится. Новый ID означает новый IP. |
| -ttl- | Минуты или часы, от `1m` до `24h`: `10m`, `2h` | Срок действия закреплённой сессии, отсчитываемый от её первого запроса. По умолчанию — `10m`, если указан `-sid-` без `-ttl-`. |


## Ротация и сессии

Без `-sid-` шлюз выбирает новый выходной узел для **каждого нового подключения**, которое получает. Клиенты, сохраняющие соединение или отправляющие много запросов через один туннель `CONNECT`, используют один выходной узел, пока существует это соединение. Чтобы менять узел при каждом запросе, отключите keep-alive или закрывайте соединение после каждого вызова; чтобы сохранять один IP между подключениями, используйте ID сессии.

- Одинаковое значение `-sid-` означает один IP при любом количестве параллельных подключений. Запускайте столько одновременных сессий, сколько нужно: ограничений нет.
- Когда срок действия истекает или домашняя сеть отключается, следующий запрос с этим ID получает **новый** IP, который по-прежнему соответствует остальным параметрам. Учитывайте это при проектировании: IP может измениться посреди процесса в любой резидентской сети.
- Чтобы немедленно сменить IP, измените ID. Идентификаторы действуют в пределах вашего аккаунта и ничего не стоят.
- Закреплённые сессии доступны в резидентском и мобильном пулах. Выделенные ISP-прокси, серверные прокси и прокси мобильных устройств имеют один фиксированный IP и игнорируют `-sid-` и `-ttl-`.


## Примеры

| Что вам нужно | Логин |
| --- | --- |
| Новый IP в любой стране при каждом подключении | USER |
| Новый IP в США при каждом подключении | USER-cc-us |
| Домохозяйство в Техасе | USER-cc-us-state-tx |
| Любой IP в Берлине | USER-cc-de-city-berlin |
| Один IP в Берлине, закреплённый на десять минут | USER-cc-de-city-berlin-sid-7f3a9 |
| Один IP в Японии, закреплённый на два часа | USER-cc-jp-sid-tokyo1-ttl-2h |
| Абонент Comcast (AS7922) | USER-cc-us-asn-7922 |
| IP из мобильной сети Deutsche Telekom, закреплённый на 15 минут | USER-cc-de-asn-3320-sid-m1-ttl-15m |
| Двадцать параллельных сессий в Бразилии | USER-cc-br-sid-w01 … USER-cc-br-sid-w20 |


## Названия городов

Значение города — это его название в нижнем регистре ASCII без пробелов, дефисов, апострофов и диакритических знаков: `New York` превращается в `newyork`, `São Paulo` — в `saopaulo`, `Düsseldorf` — в `dusseldorf`, а `Frankfurt am Main` указан как `frankfurt`. Не пытайтесь угадать значение, а используйте указанное на странице страны: именно с этой строкой выполняет сопоставление шлюз.


## Что происходит, если параметр невозможно применить

| Случай | Ответ | Что делать |
| --- | --- | --- |
| Неизвестный ключ или неверно сформированное значение (`-country-us`, `-ttl-90x`) | `400 Bad Request` | Исправьте строку; в теле ответа указан параметр. |
| `-city-` или `-state-` без `-cc-` либо `-state-` за пределами США | `400 Bad Request` | Добавьте `-cc-us` или удалите параметр. |
| Сейчас нет доступного выходного узла для сочетания параметров (например, небольшой город и один ASN) | `502 Bad Gateway` | Повторите запрос, затем расширьте выбор: удалите `-asn-`, а после него — `-city-`. |
| Параметры переданы выделенному адресу | Игнорируются | Ничего; IP фиксирован. |

> Tip: Начинайте с широкого выбора и постепенно сужайте его. Таргетинг на уровне страны предоставляет самые большие пулы и наивысшую вероятность успеха; добавляйте город и ASN, только когда они нужны для задачи, и выбирайте минимальный срок закреплённой сессии, допустимый для процесса.


Источник: https://hodlproxy.com/ru/docs/username-parameters