# 🤖 Aide-mémoire Agent

Cette page condense toutes les informations de connexion EProxies sur un seul écran, à destination des Agents IA et des développeurs qui veulent une référence rapide. Tous les exemples sont exécutables après remplacement des identifiants.

## Points d'accès

```
Passerelle proxy :  proxy.eproxies.net:23333   (port unique pour HTTP / HTTPS / SOCKS5)
Tableau de bord :   https://dashboard.eproxies.io
Extraction API :    https://api.eproxies.net/gateway_api/extract_ip   (mode liste blanche)
Liste des pays :    https://api.eproxies.net/gateway_api/country-list
```

Définition d'API lisible par machine : [spécification OpenAPI](https://www.eproxies.io/docs/openapi.json)

## Syntaxe du username (mode identifiants)

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

Règles :

* L'ordre des segments est fixe : ils se concatènent de gauche à droite selon le schéma ci-dessus, le mot de passe ne change jamais.
* `region` : code pays ISO 3166-1 à deux lettres, ex. `US`, `GB`, `JP`.
* `state` : nom complet de l'état/province, ex. `California` ; `city` : nom de ville en minuscules sans espaces, ex. `losangeles`. **`city` doit toujours être accompagné de `state`.**
* `asn` : au format `AS15802` ; **incompatible avec `state` / `city`** (combinable uniquement avec `region`).
* `sid` + `ttl` : session persistante. `sid` est une chaîne aléatoire de 8 caractères alphanumériques (générée par vos soins ; changer de `sid` change d'IP) ; `ttl` est la durée de maintien en minutes, de **1 à 120**. Sans `sid`, l'IP tourne automatiquement à chaque requête.

Exemples (du plus simple au plus complet) :

```
USERNAME-pool-flow                                                    # IP mondiale aléatoire, rotation à chaque requête
USERNAME-pool-flow-region-US                                          # IP américaine
USERNAME-pool-flow-region-US-state-California                         # Californie, États-Unis
USERNAME-pool-flow-region-US-state-California-city-losangeles         # Los Angeles, Californie, États-Unis
USERNAME-pool-flow-region-AE-asn-AS15802                              # ASN donné aux Émirats arabes unis
USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30                      # IP américaine conservée 30 minutes
```

## Exemples minimaux

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

# Proxy SOCKS5 (même port)
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));
```

## Mode liste blanche (extraction sans identifiants)

Une fois l'IP de sortie ajoutée à la liste blanche, une requête GET extrait une liste `IP:port` à utiliser en connexion directe, sans identifiants. La liste blanche elle-même est administrable par API :

```bash
# Extraction : count obligatoire ; country=code pays/Global ; protocol=http|socks5 ; format=txt|json ;
#              session=sticky|random ; separator=crlf|br|cr|lf|tab (ou st=séparateur personnalisé)
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"

# Gestion de la liste blanche (userKeyValue = clé utilisateur, à récupérer dans le tableau de bord)
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"

# Liste des pays pris en charge
curl "https://api.eproxies.net/gateway_api/country-list"
```

Voir [Extraction API](https://www.eproxies.io/docs/usage/api-extraction).

## Faits essentiels

* Les identifiants sont activés dès l'achat ; en cas de recharge après épuisement du trafic, **les identifiants restent inchangés, sans interruption de service**.
* Le trafic non consommé reste utilisable pendant la durée de validité du forfait.
* Pour changer d'IP en cours de session persistante : changez simplement de `sid`.
* Le ciblage jusqu'au niveau de la ville est sans surcoût.
* Le service est réservé aux régions situées en dehors de la Chine continentale.
* Support : [Telegram](https://t.me/eproxies) / [Discord](https://discord.gg/yzZNxN75) (24/7), e-mail `support@eproxies.io`.