Passer au contenu principal

Gérer une liste résidentielle

Renommez une liste résidentielle, changez sa rotation ou supprimez-la via l'API.

Ce guide explique comment renommer une liste résidentielle, changer sa rotation ou la supprimer.

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 — Listez les listes résidentielles

Listez vos listes résidentielles et copiez l'id de celle à gérer.

Endpoint

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

Réponse

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

Étape 2 — Renommez la liste

Renommez la liste par son id et un nouveau title.

Endpoint

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

Corps de la requête

Nom

Type

Description

id

Number

ID de la liste.

title

String

Le nouveau nom de la liste.

Réponse

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

Étape 3 — Changez la rotation

Ou changez la rotation de la liste par son id.

Endpoint

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

Corps de la requête

Nom

Type

Description

id

Number

ID de la liste.

rotation

Number

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

Réponse

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

Étape 4 — Ou supprimez la liste

Supprimez la liste par son id. C'est irréversible.

Endpoint

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

Corps de la requête

Nom

Type

Description

id

Number

ID de la liste.

Réponse

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

Référence API complète

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