đ OpenAPI
EProxies expose 5 endpoints HTTP (extraction de proxys en mode liste blanche et gestion de la liste blanche). Cette page est un aide-mémoire ; pour l'usage détaillé, voir Extraction API (mode liste blanche).
DĂ©finition lisible par machine : openapi.json â une spĂ©cification OpenAPI 3.0 Ă importer directement dans Postman / Swagger UI / Insomnia, ou Ă fournir Ă un agent IA pour un appel automatique.
Informations de base
| ĂlĂ©ment | Valeur |
|---|---|
| URL de base | https://api.eproxies.net |
| Auth (extraction) | La requĂȘte doit provenir d'une IP en liste blanche ; aucun identifiant requis |
| Auth (gestion) | ParamÚtres userName + userKeyValue (clé utilisateur, depuis le tableau de bord) |
| Passerelle proxy | proxy.eproxies.net:23333 (HTTP/HTTPS/SOCKS5 â hors de cette API HTTP) |
Liste des endpoints
GET /gateway_api/extract_ip
Extraire des proxys â Extraire un lot de points de terminaison proxy. La requĂȘte doit provenir d'une IP en liste blanche ; les proxys renvoyĂ©s s'utilisent directement, sans identifiants.
ParamĂštres de requĂȘte
| Champ | Type | Requis | Valeurs admises | Description |
|---|---|---|---|---|
count | integer | Oui | 1 ~ N | Nombre de proxys Ă extraire |
country | string | Non | US GB JP ⊠/ Global | Code pays ISO 3166-1 alpha-2 ; Global = tous pays |
protocol | string | Non | http / socks5 | Protocole du proxy |
format | string | Non | txt / json | Format de réponse ; json renvoie un tableau d'objets, txt des lignes de texte brut |
separator | string | Non | crlf br cr lf tab | SĂ©parateur pour le format txt : respectivement \r\n, </br>, \r, \n, \t |
st | string | Non | â | SĂ©parateur personnalisĂ© ; remplace separator s'il est fourni |
session | string | Non | sticky / random | Type d'IP : sticky rĂ©utilise le mĂȘme lot, random renvoie des IP alĂ©atoires |
Champs de réponse
| Champ | Type | Description |
|---|---|---|
ipAddress | string | Adresse IP du proxy |
portValue | integer | Port du proxy |
Avec format=json, la réponse est un tableau des objets ci-dessus ; avec format=txt, ce sont des lignes IP:port séparées par separator.
Exemple
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"
[
{ "ipAddress": "203.0.113.10", "portValue": 23333 },
{ "ipAddress": "203.0.113.11", "portValue": 23333 }
]
GET /gateway_api/country-list
Liste des pays pris en charge â Liste tous les pays disponibles pour l'extraction en mode liste blanche.
ParamĂštres de requĂȘte
Aucun paramĂštre de requĂȘte.
Champs de réponse
| Champ | Type | Description |
|---|---|---|
country | string | Code ISO 3166-1 alpha-2 â Ă utiliser comme paramĂštre country de extract_ip |
name | string | Nom du pays |
flag_url | string | URL de l'icĂŽne du drapeau |
Exemple
curl "https://api.eproxies.net/gateway_api/country-list"
[
{ "country": "US", "name": "United States", "flag_url": "https://file.eproxies.net/flags/us.png" }
]
GET /gateway_api/add-ip
Ajouter une IP Ă la liste blanche â Ajoute une IP de sortie Ă la liste blanche ; cette IP peut alors extraire des proxys sans identifiants.
ParamĂštres de requĂȘte
| Champ | Type | Requis | Valeurs admises | Description |
|---|---|---|---|---|
userName | string | Oui | â | Nom d'utilisateur du compte |
userKeyValue | string | Oui | â | ClĂ© utilisateur, depuis le tableau de bord |
ipAddress | string | Oui | â | Adresse IP Ă ajouter Ă la liste blanche |
Champs de réponse
Renvoie un objet de résultat ; se référer à la réponse réelle.
Exemple
curl "https://api.eproxies.net/gateway_api/add-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
GET /gateway_api/del-ip
Supprimer une IP de la liste blanche â Retire une IP de la liste blanche ; elle ne peut plus extraire sans identifiants.
ParamĂštres de requĂȘte
| Champ | Type | Requis | Valeurs admises | Description |
|---|---|---|---|---|
userName | string | Oui | â | Nom d'utilisateur du compte |
userKeyValue | string | Oui | â | ClĂ© utilisateur, depuis le tableau de bord |
ipAddress | string | Oui | â | IP Ă retirer de la liste blanche |
Champs de réponse
Renvoie un objet de résultat ; se référer à la réponse réelle.
Exemple
curl "https://api.eproxies.net/gateway_api/del-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
GET /gateway_api/lists-ip
Consulter la liste blanche â Liste toutes les entrĂ©es de la liste blanche du compte courant.
ParamĂštres de requĂȘte
| Champ | Type | Requis | Valeurs admises | Description |
|---|---|---|---|---|
userName | string | Oui | â | Nom d'utilisateur du compte |
userKeyValue | string | Oui | â | ClĂ© utilisateur, depuis le tableau de bord |
Champs de réponse
| Champ | Type | Description |
|---|---|---|
ipAddress | string | IP en liste blanche |
remarkText | string | Remarque |
Exemple
curl "https://api.eproxies.net/gateway_api/lists-ip?userName=USERNAME&userKeyValue=USER_KEY"
Appel rapide
# Extraire 10 proxys HTTP américains (JSON, IP persistantes)
curl "https://api.eproxies.net/gateway_api/extract_ip?count=10&country=US&protocol=http&format=json&session=sticky"
# Ajouter l'IP du serveur actuel Ă la liste blanche
curl "https://api.eproxies.net/gateway_api/add-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10"
Utilisation depuis un agent IA
Indiquez l'URL de la spécification à votre agent : il en déduira seul tous les paramÚtres et structures de réponse.
https://www.eproxies.io/docs/openapi.json
Avec l'aide-mémoire Agent (syntaxe des paramÚtres du username pour la passerelle proxy), vous disposez de toute la surface d'intégration.