kod.mobi
Manual Flow · Session Flow · OTP Infrastructure

API-сервис
для отправки кодов подтверждения

Один API-ключ на все каналы. Оплата только за доставленные сообщения.

Получить API-ключСценарии интеграции
TSJSnpm install @kodmobi/kodmobi-js

Без карты при регистрации · Бонус новым аккаунтам

~/kod.mobi · zsh
$curl -X POST https://api.kod.mobi/v2/create \   -H "x-api-key: PUBLIC_KEY" \   -H "Content-Type: application/json" \   -d '{ "to": "+79991234567",         "type": "telegram",         "send": true }'→{ "session_id": "01K8N1V…", "sent_to": "telegram" }
Канал доставки

99.9%

Uptime SLA

~1.2s

Доставка

4

Канала

[01] · Каналы

Один контракт. Четыре канала.

Все каналы доставки кодов — в одном API.

01

WhatsApp

Business API

3 провайдера

Cloud APIUltramsg+1

  • Cloud API

    официальный Meta, облачный

    Ultramsg

    неофициальный API

    WAAPI

    неофициальный API

02

Telegram

Gateway API

2 провайдера

Telegram BotGateway API

  • Telegram Bot

    свой бот или бот kod.mobi

    Gateway API

    официальный API Telegram для OTP

03

SMS

Global routing

2 провайдера

SMS AeroSMS Center

  • SMS Aero

    агрегатор, Россия и СНГ

    SMS Center

    агрегатор, 200+ стран

04

Email

SMTP relay

2 провайдера

SMTPPostal

  • SMTP

    ваш почтовый сервер

    Postal

    open-source MTA, выделенный IP

Нужен другой провайдер? под ваш проект.

[02] · Сравнение

До и после kod.mobi

Единый API для доставки OTP: каналы, провайдеры, fallback и статусы — в одной интеграции.

Сценарий B/ kod.mobi

С kod.mobi

Один контракт, один ключ, один SDK — всё уже настроено за вас.

  • 01Один контракт, один счёт, один API-ключ — на все каналы
  • 02SDK для TypeScript и JavaScript, готовая интеграция за 10 минут
  • 03Session Flow: kod.mobi сам генерирует и валидирует код за 3 минуты
  • 04Автоматический fallback между SMS, Telegram, WhatsApp и Email
  • 05Встроенный механизм Captcha: Turnstile, reCAPTCHA(v2/v3), SmartCaptcha
  • 06Аналитика доставки и тестовые номера — в личном кабинете
  • 07Платите только за доставленные сообщения, базовый план — бесплатно

[03] · Сценарии интеграции

Manual Flow — полный контроль над OTP.

Вы управляете логикой: сами генерируете код (или используете авто), выбираете провайдера, валидируете. kod.mobi — только маршрутизирует.

Схема интеграции · Manual

Ваш бэкенд01

Получает каналы, пользователь вводит данные

GET /manual/channels — список доступных каналов и провайдеров.

Ваш бэкенд02

Генерирует и сохраняет код

OTP, TTL, попытки — вся логика у вас.

kod.mobi03

Принимает запрос и передаёт провайдеру

Маршрутизирует к указанному вами провайдеру в выбранном канале.

Провайдер04

Доставляет сообщение

Провайдер отправляет код через SMS, Telegram, WhatsApp или Email.

Любой канал

SMS · TG · WA · Email

Логика OTP — у вас

полный контроль

Без сессий

один stateless вызов

методы и примеры
01

Получите список каналов

/manual/channels

·S2S
GET/manual/channels·S2S

Получите список каналов

Узнайте, какие каналы и провайдеры доступны вашему проекту.

  • Ответ содержит все активные каналы и провайдеры проекта
  • Покажите список пользователю — пусть выберет удобный канал
1 / 3
Request
GET https://api.kod.mobi/manual/channels
x-secret-key: SECRET_KEY
Accept: application/json
Response
[
  {
    "name": "Whatsapp",
    "type": "whatsapp",
    "providers": [
      { "id": 1, "type": "ultramsg", "is_system": true },
      { "id": 2, "type": "cloudapi", "is_system": true }
    ]
  },
  { "name": "Telegram", "type": "telegram", "providers": [...] },
  { "name": "SMS",      "type": "sms",      "providers": [...] },
  { "name": "Email",    "type": "email",    "providers": [...] }
]

[04] · Какой flow выбрать

Manual или Session — что выбрать.

Можно начать с Session за пять минут и перейти на Manual, когда нужен полный контроль: callback URL, проверка доставки и собственные провайдеры. API ключ один.

Возможность
Manual
Session
Контроль над генерацией кода
Самостоятельный выбор провайдера
Валидация кода на вашем бэке
Callback URL для статусов доставки
Проверка статуса доставленного сообщения
Лимит времени сессии
Управляемая капча и анти-фрод
Время интеграции
~30 мин
~10 мин

[05] · Цены

Платите за доставленные коды.

Платите только за доставленные сообщения. Базовый тариф бесплатен — никаких абонентских плат и скрытых списаний.

Популярный

Pro

Решение для бизнеса: масштаб, контроль, надёжность

$49/мес
  • Ваши и Kod.mobi провайдеры
  • Все каналы включены
  • Полная маршрутизация и логика fallback

Каналы и стоимость сообщения

  • WhatsApp$0 *
  • Email$0 *
  • Telegram$0 *
  • SMS$0 *
Попробовать Pro

* Бесплатно для ваших провайдеров

[06] · FAQ

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

API-сервис для доставки одноразовых кодов (OTP) через SMS, Telegram, WhatsApp и Email.

  • Один API-ключ на все каналы
  • Два режима: Manual Flow (полный контроль) и Session Flow (готовый сценарий)
  • Оплата только за доставленные сообщения
  • Мы не отправляем напрямую — маршрутизируем каждый запрос к нужному провайдеру

SMS, Telegram, WhatsApp и Email. Один API-запрос — любой канал.

Да. В обоих режимах API возвращает доступные каналы — передайте выбранный в запросе.

  • Manual Flow: GET /manual/channels — список каналов; передайте выбранный channel в POST /manual/send
  • Session Flow: GET /v2/channels — список каналов; передайте выбранный type в POST /v2/send

Провайдеры — компании, которые физически доставляют сообщения: SMS-операторы, WhatsApp BSP, Telegram-боты, SMTP-серверы.

  • kod.mobi интегрирован со множеством провайдеров по каждому каналу
  • Мы маршрутизируем трафик — вам не нужно заключать отдельные договоры
  • На тарифе Pro можно подключить собственных провайдеров

Доставка выполняется провайдером. Если сообщение не дошло, повторите с другим провайдером или каналом.

  • Session Flow: повторный вызов /v2/send с тем же session_id
  • Manual Flow: новый запрос /manual/send с другим провайдером или каналом

Одноразовый UUID-токен, подтверждающий, что пользователь ввёл правильный код. Действителен 60 секунд.

  • Возвращается /v2/check после успешной проверки кода
  • Клиент передаёт токен на свой бэкенд, бэкенд обменивает его на телефон или email через /v2/verify — запрос идёт сервер-сервер (S2S)
  • Ответ /v2/verify можно использовать как основу для авторизационной логики на вашем сервере

Да. Базовый тариф бесплатен: платите только за доставленные коды. Карта при регистрации не нужна.

  • Базовый план — 0 ₽ в месяц
  • Без карты при регистрации
  • Оплата только за доставку

У каждого проекта два ключа: API-ключ для клиентских запросов и Secret-ключ для S2S (сервер-сервер) запросов.

  • API-ключ: используется в клиентских запросах (браузер, мобильное приложение). Публичный, безопасно передавать по сети
  • Secret-ключ: используется только для S2S запросов между вашим сервером и kod.mobi. Храните его в защищённом месте, никогда не передавайте в браузер

Начните бесплатно

Регистрация — 60 секунд.
Первый код — за 5 минут.

Зарегистрируйтесь, получите API-ключ и отправьте первый код через 5 минут. На баланс сразу начисляем средства для теста. Карта не нужна.

Создать аккаунтДокументация

Связаться с нами

Контактные данные

01 / 04

Ответим в течение рабочего дня