Proxy résidentiel
Updated:
Gérer par programmation les packs de proxys résidentiels, les listes et les sessions.
Un forfait correspond à votre abonnement résidentiel : il comporte une limite de trafic et une date d'expiration. Au sein d'un forfait, vous créez des listes : des ensembles d'adresses IP nommés, filtrés selon des règles géographiques et de rotation. Vous vous connectez au proxy à l'aide de l'identifiant et du mot de passe de la liste, et un même forfait peut contenir plusieurs listes destinées à différents cas d'utilisation.
Listes
Créer, configurer et supprimer des listes de proxys
Lire
Rédiger
Pack
Plus d'options de contrôle
Commun à tous les points de terminaison résidentiels
URL de base
https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/Authentification
Clé API dans le chemin d'accès de l'URL — ne jamais enregistrer les URL de requête complètes.
Modèle d'erreur
Les erreurs métier renvoient un code HTTP 200 avec le champ errors[] renseigné.
Une fois vos proxys configurés
Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpenFAQ
Pack — votre abonnement (limite de trafic + date d'expiration). Liste — un ensemble identifiant/mot de passe avec filtres géographiques et de liste blanche, intégré à un paquet. Session — liaison de courte durée entre une adresse IP de sortie spécifique et une seule connexion, établie à la volée via _s_… suffixe lors de la connexion.
Au niveau du paquet. Une liste se résume à des identifiants et à un filtre ; consumption-cost Les agrégations s'effectuent par identifiant (c'est-à-dire par liste), mais les prélèvements réels sont imputés au pool de forfaits.
Chaque port correspond à une adresse IP de sortie distincte — utilisez-les en parallèle pour les requêtes simultanées. Un port = une adresse IP de sortie à un moment donné.
Une liste intégrée à votre package principal vous fournit un ensemble d’identifiants/filtres — mais son trafic partage le pool du package sans limite. Un sous-package se réserve une part fixe de trafic (traffic_limit) avec sa propre durée d’expiration et son propre bouton d’activation/désactivation, restituant le trafic inutilisé au package parent lors de sa suppression. Les listes que vous créez à l’intérieur fonctionnent de la même manière : elles sont simplement facturées sur la part allouée au sous-paquet.
Utilisez un sous-pack lorsque vous avez besoin d'une limite stricte de trafic pour un utilisateur (un client, une équipe, une campagne), sans pour autant divulguer votre clé API. La gestion s'effectue toujours via votre propre clé. Utilisez une simple liste lorsque vous avez uniquement besoin d'une isolation par identifiants ou géographique au sein de votre propre quota.
Oui : https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/.... Les variantes des sous-utilisateurs utilisent /residentsubuser/....
HTTP et SOCKS5 sur la même adresse IP.
Le renouvellement programmatique d’un forfait résidentiel n’est pas pris en charge par l’API publique. /extend-proxies (/prolong/calc/{type}, /prolong/make/{type}) n'accepte que les types basés sur des adresses IP — ipv4, ipv6, mobile, isp, mix, mix_isp. resident ne figure pas dans cette liste et il n'y a pas de /resident/prolong endpoint.
Renouvelez votre forfait résidentiel via le tableau de bord avant le expired_at signalé par get-package-information. Le comportement exact à l'expiration (connexions actives, report du trafic inutilisé) n'est pas documenté dans la spécification de l'API — vérifiez auprès du support technique si cela a une importance pour votre intégration.