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.