# 🤖 Referência rápida para Agents

Esta página condensa todas as informações de acesso da EProxies em uma única tela, voltada para AI Agents e desenvolvedores que precisam de consulta rápida. Todos os exemplos podem ser executados diretamente após substituir as credenciais.

## Endpoints

```
Gateway de proxy:   proxy.eproxies.net:23333   (HTTP / HTTPS / SOCKS5 na mesma porta)
Painel:             https://dashboard.eproxies.io
Extração via API:   https://api.eproxies.net/gateway_api/extract_ip   (modo whitelist)
Lista de países:    https://api.eproxies.net/gateway_api/country-list
```

Definição de API legível por máquina: [especificação OpenAPI](https://www.eproxies.io/docs/openapi.json)

## Sintaxe do username (modo usuário/senha)

```
{conta}-pool-flow[-region-{código do país}][-state-{estado}][-city-{cidade}][-asn-{ASN}][-sid-{8 caracteres aleatórios}-ttl-{minutos}]
```

Regras:

* A ordem dos segmentos é fixa: concatene da esquerda para a direita conforme o padrão acima. A senha não muda.
* `region`: código de país ISO 3166-1 de duas letras, como `US`, `GB`, `JP`.
* `state`: nome completo do estado/província, como `California`; `city`: nome da cidade em minúsculas e sem espaços, como `losangeles`. **`city` deve sempre aparecer junto com `state`.**
* `asn`: no formato `AS15802`; **mutuamente exclusivo com `state`/`city`** (só pode ser combinado com `region`).
* `sid` + `ttl`: sessão fixa (sticky). O `sid` é uma string aleatória de 8 caracteres alfanuméricos (gerada por você; trocar o sid troca o IP); o `ttl` é o tempo de retenção em minutos, no intervalo **1–120**. Sem `sid`, o IP é rotacionado automaticamente a cada requisição.

Exemplos (do mais simples ao mais completo):

```
USERNAME-pool-flow                                                    # IP global aleatório, rotação a cada requisição
USERNAME-pool-flow-region-US                                          # IP dos EUA
USERNAME-pool-flow-region-US-state-California                         # Califórnia, EUA
USERNAME-pool-flow-region-US-state-California-city-losangeles         # Los Angeles, Califórnia, EUA
USERNAME-pool-flow-region-AE-asn-AS15802                              # ASN específico nos Emirados Árabes Unidos
USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30                      # IP dos EUA, mesmo IP por 30 minutos
```

## Exemplos mínimos funcionais

```bash
# Proxy HTTP
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io

# Proxy SOCKS5 (mesma porta)
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));
```

## Modo whitelist (extração sem senha)

Depois de adicionar o IP de saída à whitelist, um GET extrai a lista `IP:porta` para conexão direta, sem usuário e senha. A própria whitelist também pode ser gerenciada via API:

```bash
# Extração: count é obrigatório; country=código do país/Global; protocol=http|socks5; format=txt|json;
#           session=sticky|random; separator=crlf|br|cr|lf|tab (ou st=separador personalizado)
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"

# Gerenciamento da whitelist (userKeyValue = chave do usuário, obtida no painel)
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"

# Lista de países suportados
curl "https://api.eproxies.net/gateway_api/country-list"
```

Veja os detalhes em [Extração via API](https://www.eproxies.io/docs/usage/api-extraction).

## Fatos importantes

* As credenciais são ativadas imediatamente após a compra; quando o tráfego acabar, compre mais — **as credenciais não mudam e não há downtime**.
* O tráfego não utilizado continua disponível dentro do período de validade do plano.
* Para trocar de IP no meio de uma sessão fixa: basta trocar o `sid`.
* A segmentação em nível de cidade não tem custo adicional.
* O serviço está disponível apenas fora da China continental.
* Suporte: [Telegram](https://t.me/eproxies) / [Discord](https://discord.gg/yzZNxN75) (24/7), e-mail `support@eproxies.io`.