В этом руководстве показано, как продлить (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 с новой датой окончания.