У цьому посібнику показано, як перейменувати residential-лист, змінити ротацію або видалити його.
Кожен запит використовує ваш персональний API-ключ з особистого кабінету (як отримати API-ключ). У прикладах нижче замініть YOUR_API_KEY на свій ключ. Щоб сплатити з балансу акаунта, використовуйте paymentId = 1.
Крок 1 — Отримайте список residential-листів
Отримайте список residential-листів і скопіюйте id того, яким хочете керувати.
Ендпоінт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Відповідь
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}
Крок 2 — Перейменуйте лист
Перейменуйте лист за його id та новим title.
Ендпоінт
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rename
Тіло запиту
Назва | Тип | Опис |
id | Number | ID листа. |
title | String | Нова назва листа. |
Відповідь
{
"status": "success",
"data": { "id": 561, "title": "New name" },
"errors": []
}
Крок 3 — Змініть ротацію
Або змініть ротацію листа за його id.
Ендпоінт
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rotation
Тіло запиту
Назва | Тип | Опис |
id | Number | ID листа. |
rotation | Number | Ротація: |
Відповідь
{
"status": "success",
"data": { "id": 561, "title": "New name" },
"errors": []
}
Крок 4 — Або видаліть лист
Видаліть лист за його id. Дія необоротна.
Ендпоінт
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/delete
Тіло запиту
Назва | Тип | Опис |
id | Number | ID листа. |
Відповідь
{
"status": "success",
"data": { "deleted": true },
"errors": []
}