Где заканчивается реферальная ссылка и начинается API
Реферальная модель направляет пользователя в готовый интерфейс и начисляет вознаграждение по правилам программы. Partner API подходит, когда партнёр управляет собственным ботом или приложением и должен программно создать заказ, проверить результат и передать доступ. Эти сценарии различаются ответственностью за интерфейс, поддержку, хранение идентификаторов и обработку ошибок.
Безопасная серверная интеграция
Секрет API должен храниться только на сервере и передаваться по защищённому каналу. Его нельзя помещать в браузерный JavaScript, мобильную сборку, QR-код или журнал. Для операций создания используйте идемпотентный идентификатор, ограничивайте частоту запросов и сохраняйте только данные, необходимые для сверки статуса.
Что должен уметь production-процесс
Интеграция обязана различать успешный ответ, временный сбой, отказ в авторизации и ошибку входных данных. Пользователь не должен получить два списания или два заказа после повторной доставки сообщения. Настройте тайм-аут, безопасный повтор, журнал без секретов, уведомление об исчерпании баланса и ручной сценарий поддержки.
Маршруты для разных партнёрских моделей
VPN API интеграция подходит продукту с собственным серверным интерфейсом, а модель VPN reseller дополнительно требует учёта баланса, поддержки и выдачи доступов. Telegram VPN бот API должен вызываться сервером партнёра: секрет нельзя передавать в Mini App, браузер или сообщение пользователю.
Материалы раздела «Партнерам и API»
10 мин чтения
Партнёрская программа VPN: модель дохода и проверка условий
Как выбрать партнёрскую программу VPN: различия реферальной ссылки и API, расчёт дохода, метрики, раскрытие рекламы, риски и подключение INFOCROSS.
Читать материал11 мин чтения
INFOCROSS Partner API: как интегрировать продажу VPN
Практическая архитектура интеграции INFOCROSS Partner API: тарифы, invoice, ключи, webhooks, idempotency, test mode и защита секретов.
Читать материал