# Sintaxe de parâmetros do username

No modo usuário/senha, toda a geolocalização e todo o controle de sessão são feitos acrescentando parâmetros ao nome de usuário; a senha permanece inalterada. Esta página é a referência completa da sintaxe.

## Estrutura da sintaxe

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

Da esquerda para a direita: corpo da conta → identificador de pool (fixo, `-pool-flow`) → parâmetros de geolocalização → parâmetros de sessão. **A ordem é fixa e não pode ser alterada.**

## Descrição dos parâmetros

| Parâmetro | Formato | Descrição |
| --- | --- | --- |
| `-pool-flow` | valor fixo | identificador do pool residencial dinâmico, obrigatório no modo usuário/senha |
| `-region-{CC}` | código ISO de duas letras | segmentação por país, como `US`, `GB`, `JP`, `AE`; gratuita em qualquer cenário |
| `-state-{State}` | nome do estado/província | deve ser usado junto com `region`, como `California` |
| `-city-{city}` | nome da cidade, minúsculas, sem espaços | **deve ser usado junto com `state`**, como `losangeles`, `newyork` |
| `-asn-{ASN}` | `AS` + números | segmentação por ASN (rede da operadora), como `AS15802`; **mutuamente exclusiva com state/city**, combina apenas com region |
| `-sid-{seed}` | 8 caracteres alfanuméricos aleatórios | identificador de sessão fixa; o mesmo sid reutiliza o mesmo IP; trocar o sid troca o IP |
| `-ttl-{n}` | inteiro, 1–120 | minutos de retenção da sessão fixa; aparece sempre em par com `sid` |

## Regras de combinação

* Só rotação, sem segmentação: `USERNAME-pool-flow`
* A segmentação pode ser refinada nível a nível: region → region+state → region+state+city
* A segmentação por ASN não pode ser usada junto com state/city
* Os parâmetros de sessão fixa vêm sempre por último
* Sem `sid`/`ttl`, vale o comportamento padrão: **rotação automática de IP a cada requisição**

## Todos os exemplos

```bash
# 1. IP global aleatório, rotação a cada requisição
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow:PASSWORD" https://ipinfo.io

# 2. País específico (EUA)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io

# 3. Até o estado (Califórnia, EUA)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California:PASSWORD" https://ipinfo.io

# 4. Até a cidade (Los Angeles, Califórnia, EUA)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles:PASSWORD" https://ipinfo.io

# 5. Segmentação por ASN (AS15802, Emirados Árabes Unidos)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-AE-asn-AS15802:PASSWORD" https://ipinfo.io

# 6. País + sessão fixa (mesmo IP dos EUA por 30 minutos)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io

# 7. Segmentação em nível de cidade + sessão fixa
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io
```

> Em dúvida sobre como montar os parâmetros? A página "Configurações de proxy" do painel tem um gerador visual: escolha país/estado/cidade/tipo de sessão e a página gera o username completo em tempo real, pronto para copiar. As listas de países e cidades suportados também estão nessa página.

## Erros comuns

| Sintoma | Causa | Solução |
| --- | --- | --- |
| Falha de autenticação (407) | erro de grafia no username ou falta do `-pool-flow` | confira com o gerador do painel |
| Segmentação por cidade não funciona | `city` sem `state` | acrescente `-state-{estado}` |
| Segmentação por ASN não funciona | misturada com `state`/`city` | ASN combina apenas com `region` |
| IP muda com frequência | sessão fixa não utilizada | acrescente `-sid-{8 caracteres}-ttl-{minutos}` |