Skip to content

Reliability

Service status

Guidelines for Cascade API and delivery channel availability.

Quick Answer

Check JSON at /api/health: online WhatsApp/Telegram sessions and the SMS configured flag.

Summary

Live platform check: https://cascade.kz/api/health. API — https://cascade.kz/api.

Key Takeaways

  • Base URL: https://cascade.kz/api.
  • Live health: GET /api/health (no token).
  • Platform SMS provider is not connected yet — channel=sms returns a clear error.

Related Questions

Live check

Machine-readable status (no API token):

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

In the response:

  • checks.whatsapp.online / total — ready platform WA sessions
  • checks.telegram.online / total — ready TG sessions
  • checks.sms.configured — whether an SMS provider is connected (usually false for now)
  • ok: false and HTTP 503 — if the DB is unavailable or there is no live messenger session

Lightweight Laravel probe: /up.

What counts as “service healthy”

  • The HTTPS site and cabinet open on cascade.kz.
  • /api/health returns ok: true and there is an online WhatsApp or Telegram session.
  • API requests with a valid Bearer token reach POST /otp/send and POST /otp/verify.
  • Required channels are enabled in the cabinet (WhatsApp / Telegram; SMS — only after a provider is connected).

Local “it doesn’t work” causes, not a platform incident

Symptom Common cause
401 Missing or wrong API key
422 “Insufficient tokens” Need a top-up
422 about the channel Channel disabled in the cabinet
422 about SMS not connected Platform SMS provider is not configured yet
Code does not arrive Wrong number, resend cooldown, recipient channel

See API errors, statuses, FAQ.

Channels

WhatsApp and Telegram are the working platform channels (usually 1 token per successful send). SMS is reserved in the API and billing (16 tokens), but the external SMS provider is not connected yet: channel=sms ends with a “channel not connected” error. Marketing price orientation — from 1 ₸.

Updates

API and product changes are recorded in the changelog. For integration use the documentation and examples.