Коды ошибок

Справочник ошибок и ответов API

При выполнении некорректного запроса к системе наше API может вернуть код ошибки, в случае же верного запроса, API вернёт ответ. Вы, конечно, уже обрабатывали ответ сервера в ходе отладки своих виджетов или написании скриптов, взаимодействующих с нашей системой. Для Вашего удобства, мы решили систематизировать все возможные ответы и ошибки, отдаваемые нашей системой и разместить их на отдельной странице. Надеемся это облегчит и ускорит интеграцию Ваших проектов с amoCRM.

Ошибки при валидации данных

Если переданные данные не совпадают с теми, что доступны для сущности, запрос вернет HTTP-код 400 Bad Request и массив с параметрами, которые не подошли под условия.

Пример ошибки валидации данных


{
    "validation-errors": [
        {
            "request_id": "0",
            "errors": [
                {
                    "code": "NotSupportedChoice",
                    "path": "custom_fields_values.0.field_id",
                    "detail": "The value you selected is not a valid choice."
                }
            ]
        }
    ],
    "title": "Bad Request",
    "type": "https://httpstatus.es/400",
    "status": 400,
    "detail": "Request validation failed"
}

Ответы при авторизации

Подробнее об авторизации читайте здесь

Код HTTP код Описание
110 401 Unauthorized Общая ошибка авторизации. Неправильный логин или пароль.
111 401 Unauthorized Возникает после нескольких неудачных попыток авторизации. В этом случае нужно авторизоваться в аккаунте через браузер, введя код капчи.
112 401 Unauthorized Возникает, когда пользователь выключен в настройках аккаунта “Пользователи и права” или не состоит в аккаунте.
113 403 Forbidden Доступ к данному аккаунту запрещён с Вашего IP адреса. Возникает, когда в настройках безопасности аккаунта включена фильтрация доступа к API по “белому списку IP адресов”.
101 401 Unauthorized Возникает в случае запроса к несуществующему аккаунту (субдомену).

Ответы при работе с контактами

Подробнее о работе с контактами читайте здесь

Код Описание
202 Добавление контактов: нет прав
203 Добавление контактов: системная ошибка при работе с дополнительными полями
205 Добавление контактов: контакт не создан
212 Обновление контактов: контакт не обновлён
219 Список контактов: ошибка поиска, повторите запрос позднее
330 Добавление/Обновление контактов: количество привязанных сделок слишком большое

Ответы при работе со сделками

Подробнее о работе со сделками читайте здесь

Код Описание
330 Добавление/Обновление сделок: количество привязанных контактов слишком большое

Ответы при работе с событиями

Подробнее о работе с событиями читайте здесь

Код Описание
244 Добавление событий: недостаточно прав для добавления события
225 Обновление событий: события не найдены

Ответы при работе с задачами

Подробнее о работе с задачами читайте здесь

Код Описание
231 Обновление задач: задачи не найдены
233 Добавление событий: по данному ID элемента не найдены некоторые контакты
234 Добавление событий: по данному ID элемента не найдены некоторые сделки
235 Добавление задач: не указан тип элемента
236 Добавление задач: по данному ID элемента не найдены некоторые контакты
237 Добавление задач: по данному ID элемента не найдены некоторые сделки
244 Добавление сделок: нет прав.

Ответы при работе со списками

Подробнее о работе со списками читайте здесь

Код Описание
244 Добавление/Обновление/Удаление каталогов: нет прав.
281 Каталог не удален: внутренняя ошибка
282 Каталог не найден в аккаунте.

Ответы при работе с элементами каталога

Подробнее о работе с элементами каталога читайте здесь

Код Описание
203 Добавление/Обновление элементов каталога: системная ошибка при работе с дополнительными полями
204 Добавление/Обновление элементов каталога: дополнительное поле не найдено
244 Добавление/Обновление/Удаление элементов каталога: нет прав.
280 Добавление элементов каталога: элемент создан.
282 Элемент не найден в аккаунте.

Ответы при работе с покупателями

Подробнее о работе с покупателями читайте здесь

Код Описание
288 Недостаточно прав. Доступ запрещен.
402 Необходимо оплатить функционал
425 Функционал недоступен
426 Функционал выключен

Другие ответы

Ошибки и ответы, не относящиеся к какому-либо конкретному разделу

Код Описание Примечание
400 Неверная структура массива передаваемых данных, либо не верные идентификаторы кастомных полей  
422 Входящие данные не мог быть обработаны.  
405 Запрашиваемый HTTP-метод не поддерживается  
402 Подписка закончилась Вместе с этим ответом отдаётся HTTP код №402 “Payment Required”
403 Аккаунт заблокирован, за неоднократное превышение количества запросов в секунду Вместе с этим ответом отдаётся HTTP код №403
429 Превышено допустимое количество запросов в секунду Вместе с этим ответом отдаётся HTTP код №429
2002 По вашему запросу ничего не найдено Вместе с этим ответом отдаётся HTTP код №204 “No Content”