Коды ошибок

Обновлено: 12 декабря 2024

к сведению

Список ошибок может быть расширен. Учитывайте это при настройке интеграции

Коды ошибок при отправке сообщений

Коды ошибок после вызова метода api/cascade/schedule

Отправка сообщений

Код	Ошибка	Описание
400	requestId-is-not-unique	Такой идентификатор запроса уже использовался. Используйте новый идентификатор для каждого запроса.
400	content-not-specified	Не указан тип контента и его свойства.
400	contentType-not-specified	Не указан тип контента. Например, text или image.
400	text-not-specified	Не заполнено текстовое поле.
400	caption-not-specified	Не заполнено текстовое поле подписи.
400	action-not-specified	Не указано действие для кнопки.
400	attachmentName-not-specified	Не указано имя прикрепляемого документа.
400	attachmentName-is-too-long	Имя прикрепляемого документа слишком длинное. Максимальная длина — 70 символов
400	latitude-not-specified	Не задана широта при указании координат.
400	longitude-not-specified	Не задана долгота при указании координат.
400	cascade-not-found	Указан неверный идентификатор каскада. Запросите список всех каскадов вашего аккаунта и проверьте корректность указанного вами идентификатора.
400	request-doesn’t-contain-content-for-all-cascade-stages	Каскад содержит много каналов. Добавьте еще один канал в объект content запроса.
400	matched-template-not-found	Схема тела запроса не соответствует схеме шаблона. Проверьте взаимное расположение и наличие всех свойств запроса.
400	cascade-scheduling-request-is-not-valid	Переданный контент для каскада не соответствует настройкам каскада. Программа edna Pulse выполняет дополнительную проверку каскада при поступлении запроса на отправку сообщения методом cascade/schedule. Если поступивший запрос не соответствует параметрам каскада, возвращается ошибка с пояснениями в поле detail. Прочитайте пояснения, чтобы выявить и устранить несоответствие или отправьте запрос в службу технической поддержки edna
400	out-of-balance	Недостаточно средств на балансе.
401	auth-error	Ошибка авторизации. Проверьте правильность написания и срок действия ключа API.
404	not-found	Запрошенный URL-адрес не найден. Проверьте корректность указанного вами адреса.
405	method-not-allowed	Метод HTTP-запроса не разрешен. Используйте POST, GET и другие запросы согласно документации.
500	system-error	Ошибка сервера. Отправьте запрос в службу технической поддержки edna. Ошибка может возникать при некорректном запросе. Проверьте взаимное расположение, наличие и заполненность всех свойств запроса согласно документации.

Примеры ошибок при проверке каскада

В объекте content есть параметры канала, которого нет в каскаде

Запрос

В запросе ниже ошибку вызывает параметр smscontent, так как каскад с cascadeId = 31634 включает в себя только каналы Viber и WhatsApp.

curl --location 'http://app.edna.by/api/cascade/schedule' \
--header 'Content-Type: application/json' \
--header 'x-api-key: ************' \
--data '{
    "requestId": "e62b4736-1278-4119-8816-3f2257eec47c",
    "cascadeId": 31634,
    "subscriberFilter": {
        "address": "+37500000000",
        "type": "PHONE"
    },
    "content": {
        "viberContent": {
            "contentType": "TEXT",
            "text": "cascade viber  --> sms "
        },
        "smsContent": {
            "contentType": "TEXT",
            "text": "cascade viber  --> sms"
        }
    }
}'

Ответ

{
    "title": "cascade-scheduling-request-not-valid",
    "status": 400,
    "detail": "Cascade scheduling request is not valid. Violations: the cascade template stage was not found for the content [cascadeTemplateId:31,634;contentChannelType:SMS]"
}

В объекте content нет параметров канала, который есть в каскаде

Запрос

В запросе передается только параметр viberContent, хотя каскад с cascadeId = 31634 включает в себя каналы Viber и WhAtsapp.

curl --location 'http://app.edna.by/api/cascade/schedule' \
--header 'Content-Type: application/json' \
--header 'x-api-key: ****************' \
--data '{
    "requestId": "7c42344c-aeea-41c9-834b-eb627136f400",
    "cascadeId": 31634,
    "subscriberFilter": {
        "address": "+37500000999",
        "type": "PHONE"
    },
    "content": {
        "viberContent": {
            "contentType": "TEXT",
            "text": "cascade viber  --> sms"
        }
    }
}'

Ответ

{
    "title": "cascade-scheduling-request-not-valid",
    "status": 400,
    "detail": "Cascade scheduling request is not valid. Violations: the content was not found for the cascade template stage [cascadeTemplateId:31,634;stageUuid:6467a97d-c0b5-486b-9f94-733297b668de;channelType:WHATSAPP]"
}

В объекте content нет параметров канала, которого нет в каскаде, и нет параметров канала, который есть в каскаде

Запрос

В запросе ниже передаются параметр viberContent и smsContent, хотя каскад с cascadeId = 31634 включает в себя каналы Viber и WhatsApp.

curl --location 'http://app.edna.by/api/cascade/schedule' \
--header 'Content-Type: application/json' \
--header 'x-api-key: **********' \
--data '{
    "requestId": "8bcb602f-ce61-4bce-a021-5dc52125a194",
    "cascadeId": 31634,
    "subscriberFilter": {
        "address": "+37500008000",
        "type": "PHONE"
    },
    "content": {
        "viberContent": {
            "contentType": "TEXT",
            "text": "cascade viber  --> sms"
        },
        "smsContent": {
            "contentType": "TEXT",
            "text": "cascade viber  --> sms"
        }
    }
}'

Ответ

{
    "title": "cascade-scheduling-request-not-valid",
    "status": 400,
    "detail": "Cascade scheduling request is not valid. Violations: the content was not found for the cascade template stage [cascadeTemplateId:31,634;stageUuid:6467a97d-c0b5-486b-9f94-733297b668de;channelType:WHATSAPP]; the cascade template stage was not found for the content [cascadeTemplateId:31,634;contentChannelType:SMS]"
}

Ошибки при получении статусов сообщений

Ошибки при неуспешной доставке сообщений и получении статуса UNDELIVERED на колбэк получения статусов сообщений.

Получение статусов сообщений

Ошибка	Описание
not-template-match	Сообщение не соответствует допустимому шаблону.
too-long-message	Длина сообщения превышает допустимый лимит.
media-request-failed	Ошибка загрузки файла.
error-subject-unknown	Указанная подпись не разрешена клиенту. Предварительно активируйте все подписи.
error-address-format	Неправильный формат номера абонента.
duplicated	Попытка отправки дубликата сообщения в течение 5 минут.