Passer au contenu principal

Configurer un sous-compte résidentiel

Créez via l'API un package de sous-utilisateur avec sa propre limite de trafic et ses listes (scénario revendeur).

Ce guide explique comment créer un package de sous-utilisateur avec sa propre limite de trafic et ses listes — utile pour la revente.

Chaque requête utilise votre clé API personnelle depuis le tableau de bord de votre compte (comment obtenir votre clé API). Dans les exemples ci-dessous, remplacez YOUR_API_KEY par votre propre clé. Pour payer avec le solde de votre compte, utilisez paymentId = 1.

Étape 1 — Créez le package de sous-utilisateur

Créez le package de sous-utilisateur avec une limite de trafic, une rotation et une expiration. Copiez le package_key depuis la réponse.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/create

Corps de la requête

Nom

Type

Description

traffic_limit

String

Limite de trafic en octets.

rotation

Number

Rotation : -1 = sticky, 0 = par requête, 1..3600 = secondes.

expired_at

String

Date d'expiration du package.

is_link_date

Boolean

Booléen — lier l'expiration au package principal.

Réponse

{
  "status": "success",
  "data": {
    "package_key": "ab12cd34ef56",
    "rotation": 60,
    "traffic_limit": "1073741824",
    "is_active": true
  },
  "errors": []
}

Étape 2 — Créez une liste d'IP dans le package

Créez une liste d'IP dans ce package en utilisant le package_key ainsi que les paramètres geo, export et rotation.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/add

Corps de la requête

Nom

Type

Description

package_key

String

Clé du package (depuis les infos du package).

title

String

Nom de la liste.

geo

object

Objet avec country, region, city, isp de la base GEO (sensible à la casse).

export

object

Objet : ports (nombre d'IP, max 1000) et ext (format d'export).

rotation

Number

Rotation : -1 = sticky, 0 = par requête, 1..3600 = secondes.

Réponse

{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
    "export": { "ports": 10000, "ext": "txt" }
  },
  "errors": []
}

Étape 3 — Confirmez le package

Listez les packages de sous-utilisateur pour confirmer que tout est correctement configuré.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/packages

Réponse

{
  "status": "success",
  "data": [
    { "package_key": "ab12cd34ef56", "traffic_limit": "1073741824", "is_active": true, "expired_at": "d.m.Y" }
  ],
  "errors": []
}

Référence API complète

Avez-vous trouvé la réponse à votre question ?