Vai al contenuto principale

Configurare un subaccount residential

Crea tramite l'API un pacchetto sub-utente con il proprio limite di traffico e le liste (scenario rivenditore).

Questa guida mostra come creare un pacchetto sub-utente con il proprio limite di traffico e liste — utile per la rivendita.

Ogni richiesta usa la tua chiave API personale dalla dashboard del tuo account (come ottenere la chiave API). Negli esempi qui sotto, sostituisci YOUR_API_KEY con la tua chiave. Per pagare con il saldo del tuo account, usa paymentId = 1.

Passo 1 — Crea il pacchetto sub-utente

Crea il pacchetto sub-utente con limite di traffico, rotazione e scadenza. Copia il package_key dalla risposta.

Endpoint

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

Corpo della richiesta

Nome

Tipo

Descrizione

traffic_limit

String

Limite di traffico in byte.

rotation

Number

Rotazione: -1 = sticky, 0 = per richiesta, 1..3600 = secondi.

expired_at

String

Data di scadenza del pacchetto.

is_link_date

Boolean

Booleano — collega la scadenza al pacchetto principale.

Risposta

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

Passo 2 — Crea una lista IP nel pacchetto

Crea una lista IP in quel pacchetto usando il package_key e le impostazioni geo, export e rotation.

Endpoint

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

Corpo della richiesta

Nome

Tipo

Descrizione

package_key

String

Chiave del pacchetto (dalle info del pacchetto).

title

String

Nome della lista.

geo

object

Oggetto con country, region, city, isp dal database GEO (case-sensitive).

export

object

Oggetto: ports (numero di IP, max 1000) ed ext (formato di esportazione).

rotation

Number

Rotazione: -1 = sticky, 0 = per richiesta, 1..3600 = secondi.

Risposta

{
  "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": []
}

Passo 3 — Conferma il pacchetto

Elenca i pacchetti sub-utente per confermare che tutto sia configurato correttamente.

Endpoint

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

Risposta

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

Riferimento API completo

Hai ricevuto la risposta alla tua domanda?