Как работает умный шлюз
Умный шлюз в OTP-кодах — режим работы через API, где вы генерируете код, а платформа доставляет его по 9 каналам с каскадом
Коротко: умный шлюз — это режим, при котором вы сами генерируете код, а платформа только доставляет его по каналам с каскадом.
Кому подходит
- Роль: Клиент, Разработчик
- Уровень: Опытный
Что это
Умный шлюз — второй режим работы OTP-сервиса. В отличие от «Под ключ», здесь вы контролируете генерацию и проверку кода, а платформа берёт на себя доставку.
Это один из двух режимов работы OTP-сервиса. Первый режим — Под ключ — когда платформа сама генерирует и проверяет код. Умный шлюз работает через API — технические детали в разделе API и интеграция.
Тестовое подключение бесплатно — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса.
Перед началом
- Вы зарегистрированы в OTP-сервисе.
- У вас есть свой механизм генерации OTP-кодов.
- У вас есть имя отправителя со статусом Активно.
- Вы готовы создать API-ключ с правами
omni-api. - Вы настроили endpoint для вебхука (если нужны статусы доставки через push).
- Вы знаете, какие каналы доступны — 9 каналов OTP.
Чем отличается от «Под ключ»
| Критерий | Под ключ (2FA) | Умный шлюз |
|---|---|---|
| Кто генерирует код | Платформа | Вы |
| Кто проверяет код | Платформа | Вы |
| Что вы получаете | «Код верный / неверный» | Статус доставки сообщения |
| Сложность интеграции | 2 запроса | 1 запрос + своя логика |
| Кому подходит | Без своего OTP-модуля | Со своим генератором кодов |
Когда использовать
- У вас уже есть свой OTP-механизм.
- Нужны специфические правила доставки.
- Нужен полный контроль над логикой.
Когда не использовать
- Нет своего OTP-механизма. Используйте режим Под ключ.
- Нужна простая интеграция за 2 запроса.
Как начать
Создайте аккаунт и получите доступ в личный кабинет сервиса.
Имя отправителя нужно для отправки сообщений по любому каналу.
Ключ используется для аутентификации в API умного шлюза.
Сформируйте запрос с кодом и правилами каскада.
Выберите каналы, successOn и timeout для каждого шага.
Карта раздела API
Технические детали — эндпоинты, параметры, форматы payload, коды ответов, статусы и ошибки.
Результат
Вы понимаете, как работает умный шлюз, чем он отличается от режима «Под ключ» и знаете, где искать технические детали.
Частые проблемы
Причина: два режима работы — «Под ключ» и «Умный шлюз» — для разных задач.
Решение: если у вас нет своего генератора кодов — «Под ключ». Если есть — «Умный шлюз».
Причина: в OTP-сервисе умные сервисы доступны только через каналы.
Решение: используйте сервис Multi API — там HLR, MNP и IMSI доступны через API.
Причина: неверный или отсутствующий API-ключ.
Решение: проверьте заголовок X-API-Key и ключ — у него должны быть права omni-api.
См. также
Нужна помощь?
- OTP-коды: support@otpcod.ru