# Syntaxe des paramètres du username

En mode identifiants, la géolocalisation et le contrôle de session se pilotent entièrement en ajoutant des paramètres à la suite du nom d'utilisateur ; le mot de passe reste inchangé. Cette page constitue la référence complète de la syntaxe.

## Structure de la syntaxe

```
{compte}-pool-flow[-region-{code pays}][-state-{état}][-city-{ville}][-asn-{ASN}][-sid-{8 caractères aléatoires}-ttl-{minutes}]
```

De gauche à droite : corps du compte → identifiant de pool (toujours `-pool-flow`) → paramètres de géolocalisation → paramètres de session. **L'ordre est fixe et ne peut pas être modifié.**

## Description des paramètres

| Paramètre | Format | Description |
| --- | --- | --- |
| `-pool-flow` | valeur fixe | identifiant du pool résidentiel dynamique, obligatoire en mode identifiants |
| `-region-{CC}` | code pays ISO à deux lettres | ciblage pays, ex. `US`, `GB`, `JP`, `AE` ; gratuit dans tous les cas |
| `-state-{State}` | nom d'état/province | à utiliser conjointement avec `region`, ex. `California` |
| `-city-{city}` | nom de ville, en minuscules, sans espaces | **obligatoirement combiné avec `state`**, ex. `losangeles`, `newyork` |
| `-asn-{ASN}` | `AS` + chiffres | ciblage ASN (réseau d'opérateur), ex. `AS15802` ; **incompatible avec state/city**, combinable uniquement avec `region` |
| `-sid-{seed}` | 8 caractères alphanumériques aléatoires | identifiant de session persistante ; un même sid réutilise la même IP, changer de sid change d'IP |
| `-ttl-{n}` | entier, 1–120 | durée de maintien de la session persistante en minutes, toujours en paire avec `sid` |

## Règles de combinaison

* Rotation seule, sans ciblage : `USERNAME-pool-flow`
* Le ciblage s'affine niveau par niveau : region → region+state → region+state+city
* Le ciblage ASN ne peut pas être utilisé en même temps que state/city
* Les paramètres de session persistante se placent toujours en dernier
* Sans `sid`/`ttl`, comportement par défaut : **rotation automatique d'IP à chaque requête**

## Tous les exemples

```bash
# 1. IP mondiale aléatoire, rotation à chaque requête
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow:PASSWORD" https://ipinfo.io

# 2. Pays donné (États-Unis)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io

# 3. Jusqu'à l'état (Californie, États-Unis)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California:PASSWORD" https://ipinfo.io

# 4. Jusqu'à la ville (Los Angeles, Californie, États-Unis)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles:PASSWORD" https://ipinfo.io

# 5. Ciblage ASN (AS15802 aux Émirats arabes unis)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-AE-asn-AS15802:PASSWORD" https://ipinfo.io

# 6. Pays + session persistante (même IP américaine conservée 30 minutes)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io

# 7. Ciblage au niveau de la ville + session persistante
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io
```

> Un doute sur l'assemblage des paramètres ? La page « Paramètres du proxy » du tableau de bord propose un générateur visuel : sélectionnez pays/état/ville/type de session et la page génère en temps réel le username complet, prêt à copier. La liste des pays et villes pris en charge s'y consulte également.

## Erreurs courantes

| Symptôme | Cause | Solution |
| --- | --- | --- |
| Échec d'authentification (407) | username mal orthographié ou `-pool-flow` manquant | vérifier avec le générateur du tableau de bord |
| Le ciblage ville ne s'applique pas | `city` utilisé sans `state` | ajouter `-state-{état}` |
| Le ciblage ASN ne s'applique pas | mélangé avec `state`/`city` | l'ASN ne se combine qu'avec `region` |
| L'IP change sans cesse | session persistante non utilisée | ajouter `-sid-{8 caractères}-ttl-{minutes}` |