К основному содержимому

Настройка residential-субаккаунта

Создайте пакет субпользователя со своим лимитом трафика и листами (для реселлера) через API.

В этом руководстве показано, как создать пакет субпользователя со своим лимитом трафика и листами — удобно для реселла.

Каждый запрос использует ваш персональный API-ключ из личного кабинета (как получить API-ключ). В примерах ниже замените YOUR_API_KEY на свой ключ. Чтобы оплатить с баланса аккаунта, используйте paymentId = 1.

Шаг 1 — Создайте пакет субпользователя

Создайте пакет субпользователя с лимитом трафика, ротацией и сроком. Из ответа скопируйте package_key.

Эндпоинт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/create

Тело запроса

Имя

Тип

Описание

traffic_limit

String

Лимит трафика в байтах.

rotation

Number

Ротация: -1 = sticky, 0 = за запрос, 1..3600 = секунды.

expired_at

String

Дата окончания пакета.

is_link_date

Boolean

Boolean — привязать срок к основному пакету.

Ответ

{
  "status": "success",
  "data": {
    "package_key": "ab12cd34ef56",
    "rotation": 60,
    "traffic_limit": "1073741824",
    "is_active": true
  },
  "errors": []
}

Шаг 2 — Создайте IP-лист в пакете

Создайте IP-лист в этом пакете, используя package_key и настройки geo, export и rotation.

Эндпоинт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/add

Тело запроса

Имя

Тип

Описание

package_key

String

Ключ пакета (из информации о пакете).

title

String

Название листа.

geo

object

Объект с country, region, city, isp из базы GEO (регистр важен).

export

object

Объект: ports (число IP, макс. 1000) и ext (формат экспорта).

rotation

Number

Ротация: -1 = sticky, 0 = за запрос, 1..3600 = секунды.

Ответ

{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
    "export": { "ports": 10000, "ext": "txt" }
  },
  "errors": []
}

Шаг 3 — Проверьте пакет

Получите список пакетов субпользователей, чтобы убедиться, что всё настроено верно.

Эндпоинт

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": []
}

Полная документация API

Нашли ответ на свой вопрос?