У цьому посібнику показано, як купити нові проксі через API з нуля — переглянути доступні варіанти, розрахувати ціну, оформити замовлення та отримати куплені IP.

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

⚠️ Крок оформлення замовлення списує кошти з балансу. Спершу завжди перевіряйте вартість на кроці розрахунку.

Стисло про процес

Перевірте баланс.
Дізнайтеся, що можна замовити (країна, період).
Виберіть спосіб оплати (або використайте баланс).
Розрахуйте ціну.
Оформіть замовлення.
Отримайте куплені проксі.

Крок 1 — Перевірте баланс

Переконайтеся, що на балансі достатньо коштів для покупки.

Ендпоінт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get

Відповідь

{
  "status": "success",
  "data": { "summ": 10 },
  "errors": []
}

Крок 2 — Дізнайтеся, що можна замовити

Reference List повертає все необхідне для замовлення: країни, періоди, цілі, операторів і ротації (для мобільних). Скопіюйте потрібні countryId та periodId.

Ендпоінт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}

Параметри шляху

Назва	Значення	Опис
type	`ipv4`	Тип проксі (ipv4, ipv6, mobile, isp, mix, mix_isp).

Приклад

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4

Відповідь

{
  "status": "success",
  "data": {
    "items": [
      {
        "country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
        "period":  [ { "id": "1m", "name": "1 month" } ]
      }
    ]
  },
  "errors": []
}

Крок 3 — Виберіть спосіб оплати

Отримайте список доступних платіжних систем і скопіюйте потрібний id як paymentId. Щоб сплатити з балансу, просто використайте paymentId = 1.

Ендпоінт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Відповідь

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Крок 4 — Розрахуйте ціну

Розрахуйте вартість замовлення перед покупкою. Знижки за обсяг і термін оренди застосовуються так само, як на сайті. Цей крок нічого не списує.

Поля тіла залежать від типу проксі. Загальні поля нижче; для IPv6 також передайте protocol, для mobile — operatorId + rotationId, для residential — tarifId — усе з Reference List.

Ендпоінт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Тіло запиту

Назва	Тип	Опис
countryId	Number	ID країни з Reference List (крок 2).
periodId	String	ID періоду оренди з Reference List.
quantity	Number	Кількість проксі для замовлення.
paymentId	Number	ID платіжної системи. `1` = баланс, `43` = прив'язана картка.
coupon (необов'язковий)	String	Код купона, якщо він у вас є.
authorization (необов'язковий)	String	Спосіб авторизації. Залиште порожнім, щоб використати логін:пароль.
customTargetName (необов'язковий)	String	Власна назва цілі/таргета, якщо потрібно.

Приклад

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Відповідь — shows the total, your balance, the discount and the per-proxy price:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 2000,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.45,
    "price": 1.8
  },
  "errors": []
}

Крок 5 — Оформіть замовлення (списує з балансу)

Коли розрахована ціна вас влаштовує, оформіть замовлення. Цей крок списує кошти з балансу. Використовуйте ті самі параметри, що й на кроці 4. З відповіді скопіюйте orderId.

Ендпоінт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Тіло запиту

Назва	Тип	Опис
countryId	Number	ID країни з Reference List (крок 2).
periodId	String	ID періоду оренди з Reference List.
quantity	Number	Кількість проксі для замовлення.
paymentId	Number	ID платіжної системи. `1` = баланс, `43` = прив'язана картка.
coupon (необов'язковий)	String	Код купона, якщо він у вас є.
authorization (необов'язковий)	String	Спосіб авторизації. Залиште порожнім, щоб використати логін:пароль.
generateAuth (необов'язковий)	String	Y/N — створити кастомну авторизацію (за замовчуванням N).

Приклад

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Відповідь — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 2426273,
    "total": 16.2,
    "listBaseOrderNumbers": [ "3388485_57471911" ],
    "balance": 1776.88
  },
  "errors": []
}

Крок 6 — Отримайте куплені проксі

Отримайте куплені проксі. Відфільтруйте за orderId з попереднього кроку, щоб побачити саме куплене.

Ендпоінт

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Відповідь

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "date_start": "23.06.2024",
        "date_end": "23.07.2024"
      }
    ]
  },
  "errors": []
}