# 🤖 Шпаргалка для агентов

Эта страница сжимает всю информацию о подключении к EProxies до одного экрана — для AI-агентов и разработчиков, которым нужна быстрая справка. Все примеры запускаются сразу после подстановки учётных данных.

## Эндпоинты

```
Прокси-шлюз:        proxy.eproxies.net:23333   (один порт для HTTP / HTTPS / SOCKS5)
Личный кабинет:     https://dashboard.eproxies.io
Извлечение по API:  https://api.eproxies.net/gateway_api/extract_ip   (режим белого списка)
Список стран:       https://api.eproxies.net/gateway_api/country-list
```

Машиночитаемое описание API: [спецификация OpenAPI](https://www.eproxies.io/docs/openapi.json)

## Синтаксис username (режим логина и пароля)

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

Правила:

* Порядок сегментов фиксированный: параметры дописываются слева направо, как в схеме выше; пароль не меняется.
* `region` — двухбуквенный код страны по ISO 3166-1, например `US`, `GB`, `JP`.
* `state` — полное название штата/региона, например `California`; `city` — название города строчными буквами без пробелов, например `losangeles`. **`city` используется только вместе со `state`.**
* `asn` — в формате `AS15802`; **несовместим со `state` / `city`** (сочетается только с `region`).
* `sid` + `ttl` — липкая сессия. `sid` — 8 случайных латинских букв и цифр (генерируете сами; смена `sid` = смена IP); `ttl` — время удержания в минутах, диапазон **1–120**. Без `sid` IP автоматически меняется на каждом запросе.

Примеры (от простого к сложному):

```
USERNAME-pool-flow                                                    # случайный IP по всему миру, ротация на каждый запрос
USERNAME-pool-flow-region-US                                          # IP из США
USERNAME-pool-flow-region-US-state-California                         # США, Калифорния
USERNAME-pool-flow-region-US-state-California-city-losangeles         # США, Калифорния, Лос-Анджелес
USERNAME-pool-flow-region-AE-asn-AS15802                              # ОАЭ, конкретный ASN
USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30                      # IP из США, тот же IP удерживается 30 минут
```

## Минимальные рабочие примеры

```bash
# HTTP-прокси
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io

# SOCKS5-прокси (тот же порт)
curl -x socks5://USERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333 https://ipinfo.io
```

```python
import requests

proxy_url = "http://USERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333"
proxies = {"http": proxy_url, "https": proxy_url}
print(requests.get("https://ipinfo.io", proxies=proxies, timeout=30).json())
```

```javascript
const { HttpsProxyAgent } = require("https-proxy-agent");
const axios = require("axios");

const agent = new HttpsProxyAgent(
  "http://USERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333"
);
axios.get("https://ipinfo.io", { httpsAgent: agent }).then((r) => console.log(r.data));
```

## Режим белого списка (извлечение без пароля)

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

```bash
# Извлечение: count обязателен; country=код_страны/Global; protocol=http|socks5; format=txt|json;
#             session=sticky|random; separator=crlf|br|cr|lf|tab (или st=свой_разделитель)
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"

# Управление белым списком (userKeyValue — ключ пользователя, берётся в личном кабинете)
curl "https://api.eproxies.net/gateway_api/add-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
curl "https://api.eproxies.net/gateway_api/del-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
curl "https://api.eproxies.net/gateway_api/lists-ip?userName=USERNAME&userKeyValue=USER_KEY"

# Список поддерживаемых стран
curl "https://api.eproxies.net/gateway_api/country-list"
```

Подробнее: [Извлечение по API](https://www.eproxies.io/docs/usage/api-extraction).

## Ключевые факты

* Учётные данные активируются сразу после покупки; после докупки трафика **учётные данные не меняются, простоя нет**.
* Неизрасходованный трафик остаётся доступным до конца срока действия тарифа.
* Сменить IP посреди липкой сессии: просто поменяйте `sid`.
* Таргетинг вплоть до города бесплатен.
* Сервис доступен только за пределами материкового Китая.
* Поддержка: [Telegram](https://t.me/eproxies) / [Discord](https://discord.gg/yzZNxN75) (24/7), почта `support@eproxies.io`.