Cascade Cascade

API

Ошибки API

Смотрите HTTP-статус и поле success в JSON.

Quick Answer

Обрабатывайте success=false и сообщения message; не полагайтесь только на HTTP-код.

Summary

401 — авторизация, 422 — бизнес/валидация, 429 — слишком много попыток. Всегда читайте message.

Key Takeaways

  • 401 = проблема с Bearer-токеном.
  • 422 = телефон, баланс, канал, cooldown.
  • 429 возможен на verify.

Содержание

  1. Таблица
  2. Примеры message

Таблица

HTTP Смысл
200 + success: true Успех
200/422 + success: false Бизнес-ошибка
401 Нет / неверный токен
422 Валидация или бизнес-правило
429 Слишком много попыток (verify)

Примеры message

  • «Неверный формат номера телефона»
  • «Недостаточно токенов рассылки. Пополните баланс.»
  • «Подождите перед повторной отправкой OTP»
  • «WhatsApp не подключён. Обратитесь к администратору.»
  • «Неверный или просроченный код»

См. rate-limits, top-up, FAQ, документация.