JavaScript SDK / HTTP-клиент

Cascade предоставляет REST API. Ниже — практический минимум на JavaScript с клиентом fetch.

Полезные ссылки: API, send, verify, examples, FAQ, pricing, documentation.

Установка

Официального npm-пакета Cascade может не быть — используйте стандартный fetch / axios на бэкенде (Node.js).

# опционально
npm install axios

Инициализация

const BASE = process.env.OTP_API_BASE_URL || 'https://otp.kztusdt.kz/api';
const TOKEN = process.env.OTP_API_TOKEN;

async function cascade(path, body) {
  const res = await fetch(`${BASE}${path}`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${TOKEN}`,
      'Content-Type': 'application/json',
      Accept: 'application/json',
    },
    body: JSON.stringify(body),
  });
  return res.json();
}

Отправка OTP

const send = await cascade('/otp/send', {
  phone: '77001234567',
  purpose: 'verification',
});
if (!send.success) throw new Error(send.message);

Verify

const verify = await cascade('/otp/verify', {
  phone: '77001234567',
  code: '482910',
  purpose: 'verification',
});
if (!verify.success) throw new Error(verify.message);

Ошибки

Проверяйте HTTP и success. Типичные случаи: 401, 422, 429. Не вызывайте API из браузера. См. errors, FAQ, документация.