Перейти к содержимому

Cascade REST API

Всё, что нужно для интеграции OTP для входа: эндпоинты, ошибки, лимиты, webhooks и SDK.

API-ключ Cascade — Bearer-авторизация

Как создать API-ключ в кабинете Cascade и использовать Authorization Bearer для cascade.kz/api.

Баланс токенов Cascade

Как работает баланс Cascade: списание кредитов за WhatsApp и Telegram, стоимость каналов, пополнение и статус ещё не запущенного публичного SMS.

Ошибки Cascade API

Разбор ошибок Cascade OTP API: HTTP 401, 422 и 429, поле success, безопасная обработка ответов и рекомендации по повторным запросам.

Примеры запросов Cascade API

Готовые curl-примеры send, verify, shorten и links/send для Cascade OTP.

История отправок Cascade

Где смотреть историю OTP и доставок в кабинете Cascade: статусы, каналы, время запросов и данные для диагностики интеграции.

Rate limits Cascade API

Ограничения Cascade для отправки и проверки OTP: resend, попытки verify, ответ HTTP 429 и безопасная стратегия повторных запросов.

Форматы ответов Cascade API

Структура JSON-ответов Cascade: success, message, expires_in, short_url.

POST /otp/send — отправка OTP

Как отправить одноразовый код через Cascade API: phone, purpose, channel, link.

Короткие ссылки Cascade API

Как сокращать и отправлять ссылки через Cascade API: POST /links/shorten, POST /links/send, срок действия и безопасное использование URL.

Статусы доставки и ответов Cascade

Как интерпретировать success, message и типовые статусы OTP в Cascade.

Пополнение баланса Cascade

Как пополнить токены для отправки OTP через WhatsApp, Telegram и SMS в Cascade.

POST /otp/verify — проверка кода

Как проверить одноразовый код через Cascade API: поля phone, code и purpose, успешный ответ, просроченный код и ограничение попыток verify.

Webhooks Cascade — статус раздела

Информация о вебхуках Cascade OTP: ориентируйтесь на синхронные ответы send/verify.