Cascade Cascade

API

Проверка OTP

Подтвердите код, который пользователь получил в WhatsApp, Telegram или SMS.

Quick Answer

Отправьте phone, code и тот же purpose на /otp/verify.

Summary

POST /api/otp/verify с тем же phone и purpose, что при send. Код одноразовый.

Key Takeaways

  • Код одноразовый — повторный verify того же кода ошибка.
  • "Возможен HTTP 429 при часты�
  • Сверяйте поле success в JSON.

Содержание

  1. Запрос
  2. Поля
  3. Ответы

Запрос

curl -sS -X POST "https://otp.kztusdt.kz/api/otp/verify" \
  -H "Authorization: Bearer $OTP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"phone":"77001234567","code":"482910","purpose":"verification"}'

Поля

Поле Обязательно
phone да
code да
purpose нет (тот же, что в send)

Ответы

Успех:

{ "success": true, "message": "Номер подтверждён" }

Ошибка:

{ "success": false, "message": "Неверный или просроченный код" }

См. send, errors, statuses, документация.