У цьому посібнику показано, як продовжити (renew) наявні проксі через API, щоб зберегти ті самі IP-адреси. Продовжуйте вчасно — після завершення терміну IP може бути втрачено.

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

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

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

Знайдіть проксі для продовження та скопіюйте їхні ID.
Виберіть спосіб оплати (або використайте баланс).
Розрахуйте вартість продовження.
Оформіть продовження.

Крок 1 — Знайдіть проксі для продовження

Отримайте список активних проксі та скопіюйте id кожного, який хочете продовжити. Продовжувати можна лише проксі з can_prolong: true. Запам'ятайте тип проксі (ipv4, ipv6, mobile, isp, mix, mix_isp) — він знадобиться на наступних кроках.

Ендпоінт

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

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

Назва	Значення	Опис
type (необов'язковий)	`ipv4`	Тип проксі для отримання. Якщо не вказано, повертаються всі типи.

Необов'язкові query-параметри

Назва	Тип	Опис
latest	String	Y/N — повернути проксі лише з останнього замовлення.
orderId	String	Повернути проксі з конкретного orderId або baseOrderNumber.
country	String	Трилітерний код країни (наприклад, FRA, USA).
ends	String	Y — лише проксі, у яких скоро завершується термін.

Приклад

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

Відповідь

{
  "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",
        "can_prolong": true,
        "date_start": "23.06.2024",
        "date_end": "23.07.2024",
        "auto_renew": "N"
      }
    ]
  },
  "errors": []
}

Скопіюйте id кожного проксі для продовження. Переконайтеся, що can_prolong дорівнює true.

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

Отримайте список доступних платіжних систем і скопіюйте потрібний 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": []
}

Крок 3 — Розрахуйте вартість продовження

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

Ендпоінт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}

Тіло запиту

Назва	Тип	Опис
ids	Number / Array	Один ID або масив ID у `[ ]` через кому — з кроку 1.
periodId	String	ID періоду продовження. Доступні періоди можна отримати через ендпоінт `/reference/list/{type}`.
paymentId	String	ID платіжної системи. `1` = баланс, `43` = прив'язана картка.
coupon (необов'язковий)	String	Код купона, якщо він у вас є.

Приклад

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

Відповідь — shows the total, your balance, the discount and the proxies being renewed:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 40.4,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [ ... proxies being renewed ... ],
    "orders": 2
  },
  "errors": []
}

Якщо на балансі недостатньо коштів, ви отримаєте попередження Insufficient funds:

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1
  },
  "errors": []
}

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

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

Ендпоінт

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}

Тіло запиту

Назва	Тип	Опис
ids	Number / Array	Один ID або масив ID у `[ ]` через кому.
periodId	String	ID періоду продовження (з `/reference/list/{type}`).
paymentId	String	ID платіжної системи. `1` = баланс.
coupon (необов'язковий)	String	Код купона, якщо він у вас є.

Приклад

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

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

{
  "status": "success",
  "data": {
    "orderId": 3388536,
    "total": 35.1,
    "listBaseOrderNumbers": [ "1000000_57471911" ],
    "balance": 40.4
  },
  "errors": []
}

Проксі зберігають ті самі IP з новою датою завершення.