Cascade Cascade

API

Отправка OTP

Эндпоинт POST /api/otp/send доставляет код на реальный телефон пользователя.

Quick Answer

POST https://otp.kztusdt.kz/api/otp/send с Bearer и полем phone.

Summary

Отправьте JSON с phone (обязательно), опционально purpose, channel, link. Авторизация Bearer.

Key Takeaways

  • Каналы: whatsapp|telegram|sms или дефолт компании.
  • expires_in обычно 300 секунд.
  • Не чаще ~1 раза в 60 сек на номер.

Содержание

  1. Запрос
  2. Поля
  3. Успех

Запрос

curl -sS -X POST "https://otp.kztusdt.kz/api/otp/send" \
  -H "Authorization: Bearer $OTP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"phone":"77001234567","purpose":"verification"}'

Поля

Поле Обязательно Описание
phone да Телефон получателя
purpose нет Сценарий, по умолчанию verification
channel нет whatsapp | telegram | sms
link нет URL, укорачивается и добавляется в сообщение
link_expires_in нет TTL короткой ссылки, 60…2592000 сек

Успех

{
  "success": true,
  "message": "OTP отправлен через WhatsApp",
  "expires_in": 300,
  "short_url": "https://otp.kztusdt.kz/s/Ab3xK9"
}

short_url только если передан link.

Далее: verify, responses, examples, FAQ.