Перейти до основного контенту

Налаштування 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

Ви отримали відповідь на своє запитання?