API Proxy5G

Все порты аккаунта: работающие, ожидающие выдачи, истёкшие и возвращённые. Новые — сверху.

• Состав полей — такой же, как у карточки порта в кабинете; описание полей ниже, в разделе «Объект порта».
• У истёкших, отключённых и возвращённых портов поля login и password равны null.

{
  "proxies": [
    {
      "id": "6f1c0d2e-8a4b-4c21-9b7d-3e5f1a2b3c4d",
      "status": "ACTIVE",
      "tariff": "Приватный",
      "tariffType": "private",
      "geo": "Москва",
      "operator": "Beeline",
      "host": "203.0.113.10",
      "port": 10101,
      "login": "u1234",
      "password": "s3cr3tPass",
      "protocol": "HTTP",
      "rotation": {
        "mode": "AUTOMATIC",
        "intervalMinutes": 5,
        "allowedIntervals": [0, 2, 5, 10, 30],
        "canRotateNow": true,
        "canChangeRotation": true
      },
      "expiresAt": "2026-11-05T09:00:00.000Z",
      "createdAt": "2026-10-06T09:00:00.000Z",
      "orderNumber": "10234",
      "renewAvailable": true
    }
  ]
}

Тот же объект, что в списке, по идентификатору id.

• id — поле id из списка (UUID). Порт другого клиента или несуществующий id — 404 NOT_FOUND.

{
  "proxy": {
    "id": "6f1c0d2e-8a4b-4c21-9b7d-3e5f1a2b3c4d",
    "status": "ACTIVE",
    "tariff": "Приватный",
    "tariffType": "private",
    "geo": "Москва",
    "operator": "Beeline",
    "host": "203.0.113.10",
    "port": 10101,
    "login": "u1234",
    "password": "s3cr3tPass",
    "protocol": "HTTP",
    "rotation": {
      "mode": "AUTOMATIC",
      "intervalMinutes": 5,
      "allowedIntervals": [0, 2, 5, 10, 30],
      "canRotateNow": true,
      "canChangeRotation": true
    },
    "expiresAt": "2026-11-05T09:00:00.000Z",
    "createdAt": "2026-10-06T09:00:00.000Z",
    "orderNumber": "10234",
    "renewAvailable": true
  }
}

Сколько денег на счёте аккаунта. Продление через API списывает именно с него.

• balance — число в рублях, копейки через точку. Пополнение — только в кабинете.

{
  "balance": 1250.5,
  "currency": "RUB"
}

Внеочередная смена внешнего адреса у приватного порта. Тело запроса не нужно.

• Только тариф private (поле tariffType). На остальных тарифах адрес меняется по расписанию канала, запрос отвечает 409 ROTATION_UNAVAILABLE до обращения к поставщику.
• Не чаще одного раза в минуту: пока не прошла минута с прошлой смены или идёт предыдущая — 429 RATE_LIMIT. Поле rotation.canRotateNow у порта показывает, можно ли сейчас.
• Если ротация для порта не предусмотрена — 403 FORBIDDEN.

{
  "changed": true,
  "message": "IP успешно изменён"
}

Как часто порт меняет адрес сам. Тело — JSON с одним целым полем intervalMinutes.

• Значение — одно из rotation.allowedIntervals у порта. 0 — ручная ротация: адрес меняется только по запросу change-ip. Другое значение — 400 VALIDATION_ERROR.
• Только тариф private, иначе 409 ROTATION_UNAVAILABLE. Та же минута ожидания после смены IP — 429 RATE_LIMIT.

{
  "intervalMinutes": 5
}

{
  "message": "Интервал ротации обновлён",
  "rotation": {
    "mode": "AUTOMATIC",
    "intervalMinutes": 5,
    "allowedIntervals": [0, 2, 5, 10, 30]
  }
}

Какие сроки можно купить порту и сколько это стоит — то же, что окно «Продлить» в кабинете. Ничего не создаёт и не списывает.

• currentPeriodDays — срок исходной покупки; у него isCurrent: true. expiresAt у варианта — до какого момента порт будет работать после продления.
• Суммы — строки с двумя знаками после точки. Значения в примере условные: действующие цены — только в ответе.
• Если продлить нельзя (renewAvailable: false у порта) — 409 CONFLICT, в details.reason причина: NOT_ACTIVE, RETENTION_ELAPSED, CHANNEL_UNAVAILABLE или NO_ORDER_CONFIG.

{
  "proxyId": "6f1c0d2e-8a4b-4c21-9b7d-3e5f1a2b3c4d",
  "currentPeriodDays": 30,
  "expiresAt": "2026-11-05T09:00:00.000Z",
  "options": [
    {
      "periodDays": 7,
      "amount": "150.00",
      "currency": "RUB",
      "isCurrent": false,
      "expiresAt": "2026-11-12T09:00:00.000Z"
    },
    {
      "periodDays": 30,
      "amount": "450.00",
      "currency": "RUB",
      "isCurrent": true,
      "expiresAt": "2026-12-05T09:00:00.000Z"
    }
  ]
}

Продление одним запросом: заказ, счёт и списание с баланса — как три шага окна «Продлить». Оба поля тела необязательны.

• periodDays — срок из renewal-options; без него берётся срок исходной покупки. Срока нет в списке — 409 CONFLICT с details.periodDays.
• expectedAmount — цена, которую вы видели в renewal-options. Если она успела измениться, ответ 409 PRICE_CHANGED с обеими суммами в details, списания нет.
• Денег на балансе не хватает — 409 INSUFFICIENT_FUNDS с суммами в details; заказ не создаётся. Пополнить баланс через API нельзя.
• Нужна принятая в кабинете действующая оферта: без неё 400 LEGAL_ACCEPTANCE_REQUIRED, API оферту за вас не принимает.
• Если оплата прошла, а продлить у поставщика не удалось: renewed: false, заказ со статусом NEEDS_SUPPORT передан в поддержку, в message — что случилось.

{
  "periodDays": 30,
  "expectedAmount": "450.00"
}

{
  "renewed": true,
  "message": "Прокси продлён на 30 дн.",
  "order": {
    "id": "0c9d2e3f-1a2b-4c5d-8e9f-0a1b2c3d4e5f",
    "number": "10234",
    "status": "PAID",
    "amount": "450.00",
    "currency": "RUB"
  },
  "payment": {
    "id": "7a8b9c0d-1e2f-4a3b-9c4d-5e6f7a8b9c0d",
    "status": "PAID"
  },
  "balance": {
    "amount": "800.50",
    "currency": "RUB"
  },
  "proxy": { "...": "объект порта, как в GET /proxies/{id}" }
}