Proxy-seller

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

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list
Récupérer les listes d'adresses IP existantes
Toutes les listes contenues dans vos packs, notamment celles des identifiants, des GEO, des rotations et des listes blanches.
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/geo
Récupérer tous les lieux
Référence des valeurs valides pour les pays, régions, villes et FAI lors de la création d'une liste.

Rédiger

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/add
Créer une liste
Créez une nouvelle liste avec un nom personnalisé, un filtre GEO et une méthode d'authentification.
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/rename
Liste des changements de nom
Modifier le nom d'affichage d'une liste sans affecter les identifiants ni les paramĂštres.
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/rotation
Modifier les paramĂštres de rotation
Définissez une rotation fixe, à la demande ou basée sur le temps (1 à 3 600 secondes).
DELETEhttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/delete
Liste des éléments à supprimer
Retirez une liste d'un paquet. Les connexions actives sont interrompues au bout d'environ 60 secondes.

Pack

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/package
Informations sur le projet
Rotation, limite de trafic, expiration, clé de pack.
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/consumption
Coût de consommation
Relevé des dépenses par liste et par période.
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/traffic/details
Utilisation du trafic
Bande passante utilisée par liste sur une période donnée.

Plus d'options de contrĂŽle

Commun à tous les points de terminaison résidentiels

  1. URL de base

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/
  2. Authentification

    ClĂ© API dans le chemin d'accĂšs de l'URL — ne jamais enregistrer les URL de requĂȘte complĂštes.

  3. 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 trafficOpen

FAQ

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.

On this page

Proxy résidentiel | Proxy-seller