IBA Platform
docs

Обработка ошибок умного шлюза

Ошибки умного шлюза — коды, причины, решения

Обработка ошибок умного шлюза

Коротко: умный шлюз возвращает HTTP-коды и текстовые ошибки. Большинство решается проверкой параметров.

Кому подходит

  • Роль: Разработчик
  • Уровень: Опытный

Основные ошибки

400 Bad Request

Причина: неверные параметры запроса.

Решения:

  1. Проверьте формат JSON.
  2. Проверьте обязательные поля: contact, messages.
  3. Проверьте типы значений.
  4. Проверьте формат номера.

401 Unauthorized

Причина: неверный API-ключ.

Решения:

  1. Проверьте заголовок X-API-Key.
  2. Проверьте, что ключ активен.
  3. Проверьте, что ключ от OTP-сервиса.

404 Not Found

Причина: неверный URL.

Решения:

  1. Проверьте базовый URL: web.otpcod.ru/api/v1.
  2. Проверьте эндпоинт: /omnimessages.

500 Internal Server Error

Причина: ошибка на стороне сервера.

Решения:

  1. Повторите запрос через 30 секунд.
  2. Сохраните requestId.
  3. Обратитесь в поддержку.

Ошибки в каскаде

Invalid senderId

Причина: имя отправителя не найдено или неактивно.

Решения:

  1. Проверьте статус имени отправителя.
  2. Проверьте, что имя указано в ключе.
  3. Дождитесь одобрения, если статус не «Активно».

Invalid channel

Причина: указан неподдерживаемый номер канала.

Решения:

  1. Проверьте список каналов.
  2. Используйте номера: 1 = SMS, 2 = RCS, 4 = WhatsApp, 11 = TTS.

Invalid payload

Причина: неверное содержимое сообщения.

Решения:

  1. Проверьте формат payload для канала.
  2. Проверьте наличие обязательных полей.
  3. Проверьте длину текста.

Timeout expired

Причина: таймаут слишком маленький.

Решения:

  1. Увеличьте timeout до 600–900 секунд.
  2. Проверьте, что указано разумное значение.

Ошибки доставки

All channels failed

Причина: все каналы в каскаде не сработали.

Решения:

  1. Проверьте EDR — какие ошибки по каналам.
  2. Проверьте номера получателей.
  3. Подключите HLR-проверку.
  4. Обратитесь в поддержку.

Contact cooldown

Причина: контакт в блокировке после предыдущей неудачи.

Решения:

  1. Дождитесь окончания cooldown.
  2. Уменьшите cooldown, если нужно.

Что приложить к обращению

  • requestId.
  • Метод и URL.
  • Тело запроса (без ключа).
  • Код ответа.
  • Время запроса.

См. также

Нужна помощь?