Proxy-seller

Sous-comptes (sous-utilisateurs)

Updated:

Créez des comptes d'utilisateurs secondaires et gérez leurs listes — sans partager vos identifiants principaux.

A paquet subuser Il s'agit d'un abonnement secondaire dérivé de votre forfait résidentiel principal. Vous lui attribuez une partie de votre volume de données et une durée de validité, et le sous-utilisateur gère lui-même ses propres listes au sein de cet abonnement.

Utilisez cette option pour les revendeurs, les membres d'une équipe ou les environnements client isolés. Le trafic consommé dans le sous-pack est déduit de votre quota principal ; en cas de suppression, le trafic non utilisé est reversé au pack parent.

Pack « Subuser »

Créer, configurer et supprimer des sous-paquets

Lire

GET/residentsubuser/packages
Obtenir les informations sur le pack
Tous les forfaits pour sous-utilisateurs avec limites de trafic, date d'expiration et clés de forfait.

Rédiger

POST/residentsubuser/create
Créer un package de sous-utilisateurs
Réservez du trafic et une période de validité à partir de votre forfait principal pour un nouveau sous-forfait.
POST/residentsubuser/update
Mise à jour du pack
Ajustez la répartition, la rotation ou la validité du trafic. Le trafic inutilisé reste dans le sous-paquet.
DELETE/residentsubuser/delete
Supprimer le package de l'utilisateur secondaire
Supprimez le sous-forfait. Tout trafic non utilisé sera facturé selon votre forfait principal.

Listes dans le paquet « subuser »

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

Lire

GET/residentsubuser/lists
Récupérer les listes d'adresses IP existantes
Toutes les listes se trouvent dans un sous-paquet. Filtrez par `package_key` ou `listId`.

Rédiger

POST/residentsubuser/list/add
Créer une liste d'adresses IP
Ajouter une liste à un sous-paquet 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 au sein d'un sous-paquet.
POST/residentsubuser/list/rotation
Modifier la rotation
Définissez une rotation fixe, à la demande ou basée sur le temps (1 à 3 600 secondes).
DELETE/residentsubuser/list/delete
Liste des éléments à supprimer
Supprimer une liste d'un sous-paquet. Les connexions actives sont interrompues au bout d'environ 60 secondes.

Spécial : liste API-TOOL

DispositionsPUT/residentsubuser/list/tools
Une 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/v2/{YourApiKey}/residentsubuser/

  2. Authentification

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

  3. Paramètre obligatoire

    La plupart des points de terminaison nécessitent un `package_key` — vous pouvez l'obtenir à partir de

    GET/fr-FR/residentsubuser/packages

  4. Modèle d'erreur

    Les erreurs métier renvoient un code HTTP 200 avec le champ « errors[] » renseigné

Connexes

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

FAQ

Non — cette appellation prête à confusion. Dans cette API, un « sous-utilisateur » est un sous-paquet: une partie de votre forfait résidentiel principal avec son propre traffic_limit, expired_at, is_active boutons bascules et listes.

Tout /residentsubuser/... points de terminaison {YourApiKey} — les vôtres. Aucune deuxième clé API n’est fournie dans la spécification. Les identifiants que votre utilisateur final reçoit sont au niveau de la liste login/password (renvoyé par /residentsubuser/list/add) — il s'agit des identifiants de connexion au proxy, et non de clés de gestion.

Non. Le sous-utilisateur ne voit que ses propres traffic_limit et consumed. Le compte principal voit les deux couches.

Appeler update-package avec une augmentation de traffic_limit. La recharge est effective immédiatement.

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

On this page

Pack « Subuser »
Lire
Rédiger
Listes dans le paquet « subuser »
Lire
Rédiger
Spécial : liste API-TOOL
Commun à tous les points de terminaison des sous-comptes
1
URL de base
2
Authentification
3
Paramètre obligatoire
4
Modèle d'erreur
Connexes
FAQ