Vai al contenuto principale

Gestire una lista residential

Rinomina una lista residential, cambia la rotazione o eliminala tramite l'API.

Questa guida mostra come rinominare una lista residential, cambiarne la rotazione o eliminarla.

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 le liste residential

Elenca le tue liste residential e copia l'id di quella da gestire.

Endpoint

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

Risposta

{
  "status": "success",
  "data": [
    { "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
  ],
  "errors": []
}

Passo 2 — Rinomina la lista

Rinomina la lista tramite il suo id e un nuovo title.

Endpoint

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

Corpo della richiesta

Nome

Tipo

Descrizione

id

Number

ID della lista.

title

String

Il nuovo titolo della lista.

Risposta

{
  "status": "success",
  "data": { "id": 561, "title": "New name" },
  "errors": []
}

Passo 3 — Cambia la rotazione

Oppure cambia la rotazione della lista tramite il suo id.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rotation

Corpo della richiesta

Nome

Tipo

Descrizione

id

Number

ID della lista.

rotation

Number

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

Risposta

{
  "status": "success",
  "data": { "id": 561, "title": "New name" },
  "errors": []
}

Passo 4 — Oppure elimina la lista

Elimina la lista tramite il suo id. È irreversibile.

Endpoint

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

Corpo della richiesta

Nome

Tipo

Descrizione

id

Number

ID della lista.

Risposta

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

Riferimento API completo

Hai ricevuto la risposta alla tua domanda?