Proxy-seller

Sous-comptes (sous-utilisateurs)

Updated:

Fournissez des paquets de sous-utilisateurs et gérez leurs listes - sans partager vos informations d'identification principales.

Apaquet sous-utilisateur est un abonnement enfant découpé dans votre formule résidentielle principale. Vous lui attribuez une tranche de trafic et une période de validité, et le sous-utilisateur gère ses propres listes à l'intérieur.

Utilisez-le pour les revendeurs, les membres de l'équipe ou les environnements clients isolés. Le trafic dépensé dans le sous-paquet est réservé à partir de votre quota principal ; en cas de suppression, le trafic non utilisé retourne au parent.

Paquet sous-utilisateur

créer, configurer et supprimer des sous-paquets

Lire

GET/residentsubuser/packages
Obtenir des informations sur le paquet
Tous les paquets de sous-utilisateurs avec les limites de trafic, l'expiration et les clés de paquets.

Écrire

POST/residentsubuser/create
Créer un paquet de sous-utilisateurs
Réservez le trafic et une période de validité de votre tarif principal pour un nouveau sous-paquet.
POST/residentsubuser/update
Mise à jour du paquet
Ajuster l'attribution, la rotation ou la validité du trafic. Le trafic non utilisé reste dans le sous-paquetage.
DELETE/residentsubuser/delete
Supprimer le paquet du sous-utilisateur
Supprimez le sous-paquet. Le trafic inutilisé retourne à votre tarif principal.

Listes dans le paquet du sous-utilisateur

mêmes opérations que les listes résidentielles parentales, limitées à un sous-paquetage

Lire

GET/residentsubuser/lists
Récupérer les listes d'adresses IP existantes
Toutes les listes d'un sous-paquetage. Filtrer par `package_key` ou `listId`.

Écrire

POST/residentsubuser/list/add
Créer une liste d'adresses IP
Ajouter une liste à un sous-paquetage avec un filtre GEO et une méthode d'authentification.
POST/residentsubuser/list/rename
Renommer la liste créée
Modifier le nom d'affichage de la liste dans un sous-paquet.
POST/residentsubuser/list/rotation
Modifier la rotation
Définir une rotation collante, par demande ou basée sur le temps (1-3600 secondes).
DELETE/residentsubuser/list/delete
Supprimer la liste
Supprimer une liste d'un sous-paquet. Les connexions actives disparaissent dans les 60 secondes.

Spécial : Liste API-TOOL

DispositionsPUT/residentsubuser/list/tools
Liste préconfigurée pour les intégrations API-TOOL. Les listes sont créées avec un nom par défaut ; renommez-les ultérieurement si nécessaire.

Commun à tous les points de terminaison des sous-comptes

  1. URL de base

    https://proxy-seller.com/personal/api/v1/{YourApiKey}/residentsubuser/

  2. Authentification

    Clé API dans le chemin d'accès à l'URL (clé de votre compte principal, pas celle du sous-utilisateur)

  3. Paramètre requis

    La plupart des points d'accès ont besoin de la clé du paquet - obtenez-la à partir de

    GET/fr-FR/residentsubuser/packages

  4. Modèle d'erreur

    Les erreurs commerciales renvoient HTTP 200 avec des erreurs[] peuplées

En rapport

Residential proxysame operations on your main packageOpenSession ID + TTLpin sessions for subuser listsOpenCases (FAQ)common subuser scenariosOpen

FAQ

Non, la dénomination est trompeuse. Dans cette API, un "sous-utilisateur" est unsous-paquet: une partie de votre paquet résidentiel principal avec son propre paquettraffic_limit,expired_at,is_active et des listes.

Tous/residentsubuser/... les points finaux prennent{YourApiKey} - la vôtre. Il n'y a pas de deuxième clé API dans la spécification. Les informations d'identification que reçoit l'utilisateur final sont des informations de niveau listelogin/password (renvoyée par/residentsubuser/list/add) - il s'agit d'informations d'identification pour le proxy, et non de clés de gestion.

Non. Le sous-utilisateur ne voit que son propretraffic_limit etconsumed. Le compte principal voit les deux couches.

Appelerupdate-package avec une augmentationtraffic_limit. Le complément est appliqué immédiatement.

Les listes sont liées au sous-paquetage dans lequel elles ont été créées. Recréez la liste sous le sous-utilisateur cible.

On this page

Paquet sous-utilisateur
Lire
Écrire
Listes dans le paquet du sous-utilisateur
Lire
Écrire
Spécial : Liste API-TOOL
Commun à tous les points de terminaison des sous-comptes
1
URL de base
2
Authentification
3
Paramètre requis
4
Modèle d'erreur
En rapport
FAQ