Przejdź do głównej zawartości

Zarządzanie listą residential

Zmień nazwę listy residential, zmień jej rotację lub usuń ją przez API.

Ten przewodnik pokazuje, jak zmienić nazwę listy residential, jej rotację lub ją usunąć.

Każde żądanie używa Twojego osobistego klucza API z panelu konta (jak uzyskać klucz API). W poniższych przykładach zamień YOUR_API_KEY na swój klucz. Aby zapłacić z salda konta, użyj paymentId = 1.

Krok 1 — Wylistuj listy residential

Wylistuj swoje listy residential i skopiuj id tej, którą chcesz zarządzać.

Endpoint

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

Odpowiedź

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

Krok 2 — Zmień nazwę listy

Zmień nazwę listy po jej id i nowym title.

Endpoint

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

Treść żądania

Nazwa

Typ

Opis

id

Number

ID listy.

title

String

Nowa nazwa listy.

Odpowiedź

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

Krok 3 — Zmień rotację

Albo zmień rotację listy po jej id.

Endpoint

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

Treść żądania

Nazwa

Typ

Opis

id

Number

ID listy.

rotation

Number

Rotacja: -1 = sticky, 0 = na żądanie, 1..3600 = sekundy.

Odpowiedź

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

Krok 4 — Albo usuń listę

Usuń listę po jej id. To nieodwracalne.

Endpoint

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

Treść żądania

Nazwa

Typ

Opis

id

Number

ID listy.

Odpowiedź

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

Pełna dokumentacja API

Czy to odpowiedziało na twoje pytanie?