У цьому посібнику показано, як оновити пакет субкористувача, керувати його листами або видалити його.
Кожен запит використовує ваш персональний API-ключ з особистого кабінету (як отримати API-ключ). У прикладах нижче замініть YOUR_API_KEY на свій ключ. Щоб сплатити з балансу акаунта, використовуйте paymentId = 1.
Крок 1 — Отримайте список пакетів субкористувачів
Отримайте список пакетів субкористувачів і скопіюйте package_key для роботи.
Ендпоінт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/packages
Відповідь
{
"status": "success",
"data": [
{ "package_key": "ab12cd34ef56", "traffic_limit": "1073741824", "is_active": true, "expired_at": "d.m.Y" }
],
"errors": []
}
Крок 2 — Оновіть пакет
Оновіть пакет: змініть ліміт трафіку, ротацію, термін або увімкніть/вимкніть через is_active.
Ендпоінт
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/update
Тіло запиту
Назва | Тип | Опис |
package_key | String | Ключ пакета (з інформації про пакет). |
traffic_limit (необов'язковий) | String | Ліміт трафіку в байтах. |
rotation (необов'язковий) | Number | Ротація: |
expired_at (необов'язковий) | String | Дата завершення пакета. |
is_active (необов'язковий) | Boolean | Boolean — |
is_link_date (необов'язковий) | Boolean | Boolean — прив'язати термін до основного пакета. |
Відповідь
{
"status": "success",
"data": {
"package_key": "ab12cd34ef56",
"rotation": 60,
"traffic_limit": "1073741824",
"is_active": true
},
"errors": []
}
Крок 3 — Керуйте листами пакета
Отримайте список листів у пакеті, потім перейменуйте лист (id + title + package_key) або видаліть за listId.
Ендпоінт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/lists
Відповідь
{
"status": "success",
"data": [
{ "id": 7788, "title": "Client A", "login": "x1y2z3", "package_key": "ab12cd34ef56" }
],
"errors": []
}
Ендпоінт — rename
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/rename
Назва | Тип | Опис |
id | Number | ID листа. |
title | String | Нова назва листа. |
package_key | String | Ключ пакета (з інформації про пакет). |
Ендпоінт — delete list
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/delete
Крок 4 — Або видаліть весь пакет
Видаліть весь пакет субкористувача за його package_key. Дія необоротна.
Ендпоінт
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/delete
Тіло запиту
Назва | Тип | Опис |
package_key | String | Ключ пакета (з інформації про пакет). |
Відповідь
{
"status": "success",
"data": { "deleted": true },
"errors": []
}