В этом руководстве показано, как переименовать 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": []
}