API в laxo использует стандартизированные числовые коды ошибок, которые на разбиты на группы. Данный раздел содержит общий список кодов ошибок, возвращаемых методами API. Детальное описание ошибок, которые может возвращать конкретный метод, приведено на странице этого метода.
По номеру ошибку можно определить ее тип и область возникновения, а по сопроводительному тексту точнее понять контекст. Текст ошибки возвращается в соответствии с параметром lang, которые может быть передан в запросе. Подробная информация о структуре запросов и ответов находится в разделе Обращение к API.
Код ошибки API всегда состоит из трех символов
ABX, гдеAB– номер компоненты системы, аx– тип ошибки. Все символы в коде – числа. Все иные коды ответов соответствуют общепринятым, если не указано иное.
| ДИАПАЗОНЫ КОДОВ ОШИБОК КОМПОНЕНТ API | |
|---|---|
| Номер | Примечание |
600 700 | Возникла неклассифицированная ошибка сервера. |
401 602 702 | Передан некорректный SID (если он является обязательным в запросе). |
608 708 | Недостаточно прав доступа. Возвращается вне зависимости от компоненты API, к которой происходит вызов. |
609 | Обработка запроса прервана по причине обновления CRM. Срабатывает, если в настоящее время происходит обновление CRM на новую версию. |
71x | Маршрутизация. |
72x | Портальная компонента (портал). |
73x | Эквайринг. |
74x | Email и push-уведомления. |
75x | Уведомления. |
76x | Расширения, в том числе конструктор форм, календарь, программа лояльности. |
77x | Управления данными и файлами конфигурации. |
78x | Промокоды и партнерская программа. |
79x | Дополнительные пользователи. |
80x | Чаты и сообщения. |
81x | Сделки, группы (отделы), воронки и статусы. |
82x | Контакты. |
83x | Задачи. |
84x | Дополнительные поля и метки (теги). |
85x | Авторизация, сессии и роли пользователей. |
86x | AI. |
88x | Автоматизация и хуки. |
| ТИПЫ ОШИБОК | |
|---|---|
| Номер | Примечание |
xx0 | Ошибки уровня данных: некорректные значения параметров, пустые обязательные поля, базовая ошибка валидации. |
xx1 | Запрашиваемый объект не найден. |
xx2 | Конфликт состояния, например объект уже существует или операция недоступна в текущем состоянии. |
xx3 | Неподдерживаемые тип операции. |
xx4 | Ошибка внешнего сервиса: SMTP, AI-провайдера, HTTP-интеграции, push-сервиса или другой внешней системы. |
xx5 | Превышение лимита: превышен тарифный лимит, квота, ограничение количества объектов или попыток. |
xx6 | Компонента недоступна: метод отключен, расширение выключено. |
xx7 | Внутренняя ошибка выполнения. |
xx8 | Ошибка загрузки файла, импорта или экспорта. |
xx9 | Другое: редкие специфические ошибки, не относящиеся к другим категориям. |