Vai al contenuto principale

Gestire un subaccount

Aggiorna un pacchetto sub-utente (traffico / scadenza / on-off), gestisci le sue liste o eliminalo tramite l'API.

Questa guida mostra come aggiornare un pacchetto sub-utente, gestire le sue liste o eliminarlo.

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 — Elenca i pacchetti sub-utente

Elenca i pacchetti sub-utente e copia il package_key con cui lavorare.

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

Passo 2 — Aggiorna il pacchetto

Aggiorna il pacchetto: cambia limite di traffico, rotazione, scadenza o attivalo/disattivalo con is_active.

Endpoint

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

Corpo della richiesta

Nome

Tipo

Descrizione

package_key

String

Chiave del pacchetto (dalle info del pacchetto).

traffic_limit (opzionale)

String

Limite di traffico in byte.

rotation (opzionale)

Number

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

expired_at (opzionale)

String

Data di scadenza del pacchetto.

is_active (opzionale)

Boolean

Booleano — true attivo, false inattivo (attiva/disattiva pacchetto).

is_link_date (opzionale)

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 3 — Gestisci le liste del pacchetto

Elenca le liste del pacchetto, poi rinomina una lista (id + title + package_key) o eliminane una tramite il suo listId.

Endpoint

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

Risposta

{
  "status": "success",
  "data": [
    { "id": 7788, "title": "Client A", "login": "x1y2z3", "package_key": "ab12cd34ef56" }
  ],
  "errors": []
}

Endpoint — rename

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

Nome

Tipo

Descrizione

id

Number

ID della lista.

title

String

Il nuovo titolo della lista.

package_key

String

Chiave del pacchetto (dalle info del pacchetto).

Endpoint — delete list

DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/delete

Passo 4 — Oppure elimina l'intero pacchetto

Elimina l'intero pacchetto sub-utente tramite il suo package_key. È irreversibile.

Endpoint

DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/delete

Corpo della richiesta

Nome

Tipo

Descrizione

package_key

String

Chiave del pacchetto (dalle info del pacchetto).

Risposta

{
  "status": "success",
  "data": { "deleted": true },
  "errors": []
}

Riferimento API completo

Hai ricevuto la risposta alla tua domanda?