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

Надёжность

Статус сервиса

Ориентиры по доступности API и каналов доставки Cascade.

Краткий ответ

Смотрите JSON на /api/health: online-сессии WhatsApp/Telegram и флаг SMS configured.

Кратко

Live-проверка платформы: https://cascade.kz/api/health. API — https://cascade.kz/api.

Главное

  • Базовый URL: https://cascade.kz/api.
  • Live health: GET /api/health (без токена).
  • SMS-провайдер платформы пока не подключён — channel=sms вернёт понятную ошибку.

Связанные вопросы

Live-проверка

Машинно-читаемый статус (без API-токена):

GET https://cascade.kz/api/health

В ответе:

  • checks.whatsapp.online / total — готовые WA-сессии платформы
  • checks.telegram.online / total — готовые TG-сессии
  • checks.sms.configured — подключён ли SMS-провайдер (сейчас обычно false)
  • ok: false и HTTP 503 — если БД недоступна или нет ни одной живой messenger-сессии

Лёгкий probe Laravel: /up.

Что считать «сервисом в норме»

  • HTTPS-сайт и кабинет открываются на cascade.kz.
  • /api/health отдаёт ok: true и есть online WhatsApp или Telegram.
  • Запросы к API с валидным Bearer-токеном доходят до POST /otp/send и POST /otp/verify.
  • В кабинете включены нужные каналы (WhatsApp / Telegram; SMS — только после подключения провайдера).

Локальные причины «не работает», не инцидент платформы

Симптом Частая причина
401 Нет или неверный API-ключ
422 «Недостаточно токенов» Нужно пополнение
422 про канал Канал выключен в кабинете
422 про SMS не подключён SMS-провайдер платформы ещё не настроен
Код не приходит Неверный номер, cooldown повторной отправки, канал получателя

См. ошибки API, статусы, FAQ.

Каналы

WhatsApp и Telegram — рабочие каналы платформы (обычно 1 токен за успешную отправку). SMS в API и биллинге заложен (16 токенов), но внешний SMS-провайдер пока не подключён: channel=sms завершится ошибкой «канал не подключён». Маркетинговый ориентир цены — от 1 ₸.

Обновления

Изменения API и продукта фиксируем в changelog. Для интеграции используйте документацию и примеры.