Мазмұнға өту

Use case

Әзірлеушілер үшін

Бірнеше минутта бэкендке OTP API интеграциясының практикалық ағыны.

Қысқа жауап

Әзірлеуші үшін Cascade интеграциясы: кабинеттегі кілт → Authorization Bearer → /otp/send → пайдаланушы кодты енгізеді → /otp/verify. Негізгі URL https://cascade.kz/api.

Қысқаша

Bearer-токен алыңыз, POST /otp/send және POST /otp/verify шақырыңыз, 401/422/429 өңдеңіз. Кілт тек серверде.

Негізгі

  • Кілт тек серверде.
  • /api/errors және rate limits қараңыз.
  • WA/TG токен бойынша SMS-тан арзанырақ.

Байланысты сұрақтар

Міндет

Шығыс 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 = 3 токен, SMS = 8 — /pricing
SDK /sdk
Толық нұсқаулық /docs

Шектеулер

100% жеткізуге уәде бермеңіз: арналар желіге байланысты. SMS-ты қымбатырақ fallback ретінде ұстаңыз. Өнім сценарийлері: /use-cases/saas және арна /use-cases/telegram.