Cascade Cascade
Русский English Қазақша

Use case

Для разработчиков

Практический поток интеграции OTP API в бэкенд за несколько минут.

Quick Answer

Интеграция Cascade для разработчика: ключ в кабинете → Authorization Bearer → /otp/send → пользователь вводит код → /otp/verify. Базовый URL https://cascade.kz/api.

Summary

Возьмите Bearer-токен, вызовите POST /otp/send и POST /otp/verify, обработайте 401/422/429. Ключ только на сервере.

Key Takeaways

  • Ключ только на сервере.
  • Смотрите /api/errors и rate limits.
  • WA/TG дешевле SMS по токенам.

Related Questions

Содержание

  1. Задача
  2. Минимальный поток
  3. Что обработать сразу
  4. Ограничения

Задача

Встроить исходящий OTP в бэкенд без лишней обвязки.

Минимальный поток

  1. Создайте компанию и API-ключ в кабинете.
  2. На сервере храните токен (не в фронтенде).
  3. POST https://cascade.kz/api/otp/send с телефоном пользователя.
  4. Покажите форму ввода кода.
  5. POST https://cascade.kz/api/otp/verify.
  6. При ошибках смотрите код ответа и тело.

Пример идеи запроса (псевдо):

POST /api/otp/send
Authorization: Bearer <token>
Content-Type: application/json

{"phone":"+77001234567"}

Что обработать сразу

Тема Куда смотреть
Неверный ключ 401 — /api/errors
Валидация 422
Лимиты 429 — /api/rate-limits
Биллинг WA/TG = 1 токен, SMS = 16 — /pricing
SDK /sdk
Полный гайд /docs

Ограничения

Не обещайте 100% доставку: каналы зависят от сети. Держите SMS как более дорогой fallback. Для продукта удобны сценарии /use-cases/saas и канал /use-cases/telegram.

FAQ

Где OpenAPI?
https://cascade.kz/openapi.yaml и справочник /api.
С чего начать?
Ключ → POST /otp/send → POST /otp/verify → мониторинг в кабинете.
Документация API Тарифы FAQ