Интеграция API NEONPROXY в свой сервис
Ручная покупка прокси в кабинете подходит для разовых задач. SaaS-платформы, парсеры и внутренние инструменты компаний требуют автоматизации: пополнение пула по расписанию, выдача адресов клиентам, продление перед истечением срока. REST API v2 NEONPROXY закрывает эти сценарии — в статье разберём типовую архитектуру интеграции и подводные камни продакшена.
С чего начать
API-ключ генерируется в личном кабинете на вкладке «Разработчикам». Передавайте его в заголовке Authorization: Bearer YOUR_API_KEY. Базовый URL: https://api.svyaz.mom/v2. Полная справка по эндпоинтам — на странице /developers/.
Храните ключ в переменных окружения или секрет-хранилище, не коммитьте в репозиторий. Для staging и production используйте разные ключи с раздельными балансами.
Типовой сценарий: заказ и выдача
Последовательность для автопокупки:
1. Проверить баланс GET /balance. 2. Убедиться в наличии слотов GET /stock?type=ipv6&country=de. 3. Создать заказ POST /order с телом {"type":"ipv6","country":"de","count":10,"period":30}. 4. Сохранить order_id и массив прокси из ответа в свою БД.
Синхронизация списка прокси
Эндпоинт GET /proxies возвращает активные адреса с полями expires_at. Запускайте cron раз в час: обновляйте локальный кэш, помечайте истекающие за 24 часа и инициируйте автопродление через POST /renew, если включена опция в кабинете.
Не опрашивайте API чаще необходимости — лимит 60 запросов в минуту на ключ. При пиках используйте очередь с backoff при ответе 429 rate_limited.
Webhook-уведомления
В настройках API можно указать URL для событий: успешный заказ, истечение срока, низкий баланс. Обработчик должен проверять подпись HMAC из заголовка X-Neon-Signature — так вы отсечёте поддельные запросы. Отвечайте HTTP 200 в течение 5 секунд; тяжёлую логику выносите в фоновую задачу.
Обработка ошибок в продакшене
402 insufficient_balance — пополните баланс или уведомите администратора. 409 out_of_stock — переключитесь на другую страну из /stock или поставьте заказ в очередь. 400 invalid_params — валидируйте type, country, count и period на своей стороне до вызова API.
Логируйте request_id из ответа — поддержка NEONPROXY быстрее найдёт инцидент по нему.
Архитектурные рекомендации
Выделите сервис-обёртку над API: единая точка для retry, метрик и circuit breaker. Прокси из ответа нормализуйте в формат ваших воркеров — например, URL для requests или host:port для браузерных профилей.
Не отдавайте клиентам API-ключ NEONPROXY напрямую. Ваш бэкенд покупает прокси и выдаёт только необходимые credentials конечному пользователю — так вы контролируете расходы и аудит.
Тестирование перед релизом
Создайте заказ на 1 адрес с периодом 3 дня, проверьте через чекер, выполните renew и delete (если поддерживается в вашем тарифе). Прогоните сценарий «нулевой баланс» и «нет слотов» — UI должен показывать понятные сообщения, а не сырой JSON.