Заказ прокси-канала через личный кабинет вручную работает, пока каналов десяток. Как только счёт идёт на сотни и продление нужно синхронизировать с расходом бюджета, ручной режим ломается — и в дело вступает API. Разберём типовой цикл выдачи и продления канала, разницу между выделенным адресом и пакетом трафика, и что делать, если в нужной стране нет стока.

Типовой цикл: от каталога до продления

Работа с API прокси строится по одной схеме независимо от типа канала. Сначала запрашивается каталог: список доступных типов, стран и текущих цен — по нему видно, что вообще есть в наличии, прежде чем оформлять заказ. Дальше идёт заказ конкретного канала с указанием типа и страны, в ответ на который API возвращает креды подключения — адрес, порт, логин и пароль, которые сразу можно вставлять в рабочий процесс. Пока канал активен, его состояние отслеживается отдельным запросом: остаток трафика для пакетных тарифов или срок действия для выделенного адреса. Завершается цикл продлением, если ресурс всё ещё нужен, либо отказом от канала, если задача выполнена и платить за простой смысла нет.

Выделенный адрес против пакета гигабайт

Выделенный датацентровый или ISP-адрес тарифицируется помесячно: вы платите фиксированную цену за срок, адрес держится за вами весь оплаченный период, а продление — это просто новый платёж на новый срок. Резидентные и мобильные каналы устроены иначе: тарификация идёт по гигабайтам, а сам адрес выдаётся посессионно — при новом запросе или по таймауту сессии система может выдать другой IP из пула. Различие важно на этапе интеграции: код, который держит один и тот же адрес в переменной на весь скрипт, ломается на посессионных каналах и требует перезапроса адреса на каждую новую сессию. Подробный разбор того, когда выгоднее один тип, а когда другой, — в статье мобильные против резидентных прокси.

Как опрашивать расход трафика без лишней нагрузки

Расход трафика по пакетным каналам меняется не мгновенно после каждого запроса — данные синхронизируются с задержкой, и опрос эндпоинта расхода каждую секунду не даёт более свежих цифр, только расходует лимит запросов. Разумная практика — проверять остаток раз в несколько минут или привязывать проверку к завершению крупного блока задач, а не к каждому отдельному запросу через прокси. Тот же принцип разумного интервала работает и в других частях каталога — например, при настройке ротации IP по API: частый опрос не ускоряет результат, а просто тратит лимит.

Когда в нужной стране нет стока

Каталог явно возвращает статус отсутствия стока для конкретной страны и типа канала, а не тайм-аут или общую ошибку — это позволяет обработать ситуацию в коде, а не гадать, что пошло не так. Рабочих вариантов три: подождать и повторить запрос позже, если пул пополняется регулярно; переключиться на соседнюю страну того же региона, если гео не критично; или уточнить у поддержки через тикет ожидаемые сроки пополнения по конкретному направлению. Закладывать в автоматизацию только штатный сценарий без обработки пустого стока — частая причина, по которой скрипт падает в проде вместо аккуратного перехода к запасному варианту.

Хранение и ротация выданных кредов

Креды подключения — адрес, порт, логин и пароль — стоит хранить так же, как любой секрет: в переменных окружения или менеджере секретов, а не в коде скрипта. Провайдер не меняет логин и пароль канала автоматически в фоне, поэтому ротация — это ответственность клиента: при подозрении на утечку кредов канал стоит перезаказать заново, а не пытаться сменить пароль у уже выданного ресурса. Полный список активных каналов, их статус и креды удобно сверять в личном кабинете — там же видно, какие ресурсы скоро истекают и требуют продления.

Частые вопросы

Можно ли получить креды сразу после заказа, без ожидания?

Да, API возвращает креды подключения синхронно в ответе на запрос заказа — отдельного шага активации, требующего опроса, для прокси нет, в отличие от email-активаций, где нужно ждать входящее письмо.

Что происходит с каналом, если не продлить его вовремя?

Выделенный адрес по истечении оплаченного срока освобождается и может быть выдан другому клиенту, поэтому продление стоит планировать заранее. Пакетные каналы просто перестают отвечать при исчерпании трафика или окончании расчётного периода, без штрафов и блокировок аккаунта.

Нужно ли уведомлять API об отказе от канала или достаточно перестать им пользоваться?

Лучше явно вызвать отказ от канала через API: это освобождает ресурс сразу, а не по истечении срока, и останавливает начисление, если тариф предполагает автопродление.

Полное описание методов заказа, продления и мониторинга — в технической документации API. Актуальные типы и страны — в разделе прокси.