Ошибки API: HTTP-коды

200 OK — запрос обработан успешно. Тело содержит результат.

202 Accepted — запрос принят. Используется в OMNI API: сообщение поставлено в очередь на отправку.

Статус доставки можно получить двумя способами:

• Push — платформа сама отправит статус на ваш вебхук, когда сообщение изменит состояние.
• Pull — вы запрашиваете статусы самостоятельно через эндпоинт GET /edrs.

204 No Content — запрос выполнен, но тело пустое. Используется при удалении — шаблоны рассылок, атрибуты, получатели.

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

Решение:

1. Проверьте формат JSON — нет ли лишних запятых или кавычек.
2. Проверьте обязательные поля: contact, channel, senderId, phoneNumber, type.
3. Проверьте типы значений — числа не в кавычках, строки в кавычках.
4. Проверьте формат номера телефона — с кодом страны, без «+».

Частые сообщения:

• Phone number can't be null or empty
• Recipient type can't be null
• Selected filter's attributes don't exist.

Обработка ошибок API →

Что значит: неверный или отсутствующий API-ключ.

Решение:

1. Проверьте, что заголовок X-API-Key передан в запросе.
2. Проверьте, что ключ активен и не удалён.
3. Проверьте, что ключ от нужного сервиса — ключ от OTP не работает на Multi API.
4. Если старый ключ удалён — создайте новый.

Ошибка 401 и 403 →

Что значит: у ключа нет нужного права (scope).

Решение:

1. Откройте настройки ключа в разделе API Подключения.
2. Проверьте список scopes.
3. Добавьте нужный scope: omni-api, statistics, recipients, broadcasts, dids, crm.
4. Сохраните изменения.

Ошибка 401 и 403 →

Что значит: неверный URL или несуществующий ID.

Решение:

1. Проверьте базовый URL вашего сервиса — web.otpcod.ru, web.multiapi.ru, web.mydialogi.ru.
2. Проверьте ID ресурса: шаблона, получателя, рассылки.
3. Проверьте метод запроса (GET, POST, PUT, DELETE).

Что значит: конфликт данных — например, попытка создать дубликат.

Решение:

1. Проверьте, не создан ли уже такой ресурс.
2. Используйте уникальные идентификаторы.
3. Если конфликт по email — используйте номер телефона (он уникален).

Что значит: данные не прошли валидацию.

Решение:

1. Проверьте формат email.
2. Проверьте формат номера телефона.
3. Проверьте длину полей — не превышены ли лимиты.
4. Проверьте, что значения соответствуют допустимым — например, type только ENRICH, NOT_IMPORT или OVERWRITE.

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

Решение:

1. Уменьшите частоту запросов.
2. Используйте очереди.
3. Обратитесь в поддержку, если лимит критично низкий.

Ошибка 429 →

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

Решение:

1. Повторите запрос через 30 секунд.
2. Сохраните requestId (OMNI API) или execId (Broadcasts и Recipients).
3. Если ошибка повторяется — обратитесь в поддержку с этими идентификаторами.

Что значит: ошибка шлюза между сервисами.

Решение:

1. Повторите запрос через 10–30 секунд.
2. Если повторяется — обратитесь в поддержку.

Что значит: сервис временно недоступен — идут технические работы или перегрузка.

Решение:

1. Подождите 1–2 минуты.
2. Повторите запрос.
3. Если не помогает — обратитесь в поддержку.