В этом руководстве показано, как обновить пакет субпользователя, управлять его листами или удалить его.
Каждый запрос использует ваш персональный 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": []
}