API pour les proxies résidentiels
Nous proposons des proxies résidentiels facturés au trafic. Pour que l’API fonctionne correctement, il faut acheter du trafic pour les proxies résidentiels. Si votre trafic est épuisé, certaines requêtes ne fonctionneront pas.
Requêtes à l’API
Une clé est nécessaire pour utiliser l'API. Vous la trouverez sur la page Profil.
Format général d’une requête :
https://thesafety.us/getapi?key=[API ключ]&act=[имя запроса]
Trafic restant
Pour vérifier le trafic restant, utilisez act=traffic
https://thesafety.us/getapi?key=[API ключ]&act=traffic
La réponse sera au format XML.
Le champ auth = true si la clé API est valide.
Le champ resident-traffic-in-mb indique le trafic restant en mégaoctets.
Liste des pays, villes et États
La liste à jour peut être obtenue avec act=countries
https://thesafety.us/getapi?key=[API ключ]&act=countries
La réponse sera au format XML.
Le champ auth = true si la clé API est valide.
Le champ resident contient les balises country (nom complet du pays) et code (code du pays). Pour l’API, vous devez indiquer code (code du pays).
Pour certains pays, les villes figurent dans la balise city et les États dans la balise state. Les villes et les États sont présentés sous forme de listes séparées par des virgules.
Génération d’une liste de proxies
Vous pouvez obtenir la liste des proxies avec act=getresproxy
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy
La réponse sera au format text/plain. Cette requête fournira un proxy de n'importe quel pays avec une adresse IP dynamique. Le pays et l'adresse IP seront choisis aléatoirement à chaque requête.
Paramètres supplémentaires :
| Paramètre | Commentaire |
|---|---|
| &base= | Base de proxies :
Ce paramètre peut être obtenu avec la requête act=countries S'il n'existe qu'une seule base de proxies, le paramètre peut être absent. |
| &type= | Type de proxy :
http = proxy HTTP/HTTPS socks5 = proxy Socks5 Si type n'est pas indiqué, http est utilisé par défaut. |
| $list= | Format de la liste des proxies :
hpup = hostname:port:username:password hp@up = hostname:port@username:password uphp = username:password:hostname:port up@hp = username:password@hostname:port Si list n’est pas indiqué, hpup est utilisé par défaut. |
| Choix du pays, de la ville et de l'État | |
| &country= | Code pays à 2 lettres [paramètre code de la requête act=countries] |
| &city= | Nom de la ville [paramètre city de la requête act=countries]
Le système tentera de fournir des adresses IP dans la zone indiquée, sans garantie. Ne l'utilisez pas en même temps que le paramètre &state= Fonctionne uniquement si le pays est également indiqué &country= |
| &state= | Nom de l'État [paramètre state de la requête act=countries]
Le système tentera de fournir des adresses IP dans la zone indiquée, sans garantie. Ne l'utilisez pas en même temps que le paramètre &city= Fonctionne uniquement si le pays est également indiqué &country= |
| Obtention d'une adresse IP statique | |
| &session=1 | Indique d'utiliser une adresse IP statique, définie dans le mot de passe du proxy via le paramètre session.
Si session n'est pas indiqué, 1 proxy avec une adresse IP dynamique changeant à chaque requête est toujours fourni. Le changement d'adresse IP est effectué sur le serveur proxy et ne nécessite aucun réglage supplémentaire de votre part. |
| &amount= | Indique le nombre de proxies à générer.
Valeurs possibles à partir de 1 jusqu’à 1000. Fonctionne uniquement avec le paramètre &session=1 |
| &lifetime= | Délai après lequel l’adresse IP statique est remplacée par une nouvelle.
Valeurs possibles en secondes, minutes et heures : 5-59s, 1-59m, 1-24h Exemple : 30s - changer d'adresse IP toutes les 30 secondes 10m - changer d'adresse IP toutes les 10 minutes 6h - changer d'adresse IP toutes les 6 heures Le système essaiera de respecter le paramètre indiqué, sans garantie.
Fonctionne uniquement avec le paramètre &session=1 |
Exemples de requêtes :
Liste de 10 proxies HTTP/HTTPS avec une adresse IP statique en Allemagne au format up@hp
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=de&type=http&list=up@hp&session=1&amount=10
Proxies Socks5 avec adresse IP dynamique aux États-Unis au format hpup
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&type=socks5&list=hpup
Proxy HTTP/HTTPS avec adresse IP dynamique aux États-Unis, dans l'Utah
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&state=utah
Proxy HTTP/HTTPS avec une adresse IP dynamique au Canada, ville de Montreal
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=ca&city=montreal
Vous avez des suggestions pour améliorer l'API ? Contactez-nous.