Коды ошибок

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

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

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

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

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

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

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

Код Описание
101 Аккаунт не найден
102 POST-параметры должны передаваться в формате JSON
103 Параметры не переданы
104 Запрашиваемый метод API не найден

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

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

Код Описание
201 Добавление контактов: пустой массив
202 Добавление контактов: нет прав
203 Добавление контактов: системная ошибка при работе с дополнительными полями
204 Добавление контактов: дополнительное поле не найдено
205 Добавление контактов: контакт не создан
206 Добавление/Обновление контактов: пустой запрос
207 Добавление/Обновление контактов: неверный запрашиваемый метод
208 Обновление контактов: пустой массив
209 Обновление контактов: требуются параметры “id” и “updated_at”
210 Обновление контактов: системная ошибка при работе с дополнительными полями
211 Обновление контактов: дополнительное поле не найдено
212 Обновление контактов: контакт не обновлён
219 Список контактов: ошибка поиска, повторите запрос позднее
330 Добавление/Обновление контактов: количество привязанных сделок слишком большое

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

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

Код Описание
213 Добавление сделок: пустой массив
214 Добавление/Обновление сделок: пустой запрос
215 Добавление/Обновление сделок: неверный запрашиваемый метод
216 Обновление сделок: пустой массив
217 Обновление сделок: требуются параметры “id”, “updated_at”, “status_id”, “name”‘
240 Добавление/Обновление сделок: неверный параметр “id” дополнительного поля
330 Добавление/Обновление сделок: количество привязанных контактов слишком большое

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

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

Код Описание
218 Добавление событий: пустой массив
221 Список событий: требуется тип
226 Добавление событий: элемент события данной сущности не найден
244 Добавление событий: недостаточно прав для добавления события
222 Добавление/Обновление событий: пустой запрос
223 Добавление/Обновление событий: неверный запрашиваемый метод (GET вместо POST)
224 Обновление событий: пустой массив
225 Обновление событий: события не найдены

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

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

Код Описание
227 Добавление задач: пустой массив
228 Добавление/Обновление задач: пустой запрос
229 Добавление/Обновление задач: неверный запрашиваемый метод
230 Обновление задач: пустой массив
231 Обновление задач: задачи не найдены
232 Добавление событий: ID элемента или тип элемента пустые либо неккоректные
233 Добавление событий: по данному ID элемента не найдены некоторые контакты
234 Добавление событий: по данному ID элемента не найдены некоторые сделки
235 Добавление задач: не указан тип элемента
236 Добавление задач: по данному ID элемента не найдены некоторые контакты
237 Добавление задач: по данному ID элемента не найдены некоторые сделки
238 Добавление контактов: отсутствует значение для дополнительного поля
244 Добавление сделок: нет прав.

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

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

Код Описание
405 Метод передачи запроса неверный
222 Добавление/Обновление/Удаление каталогов: пустой запрос
244 Добавление/Обновление/Удаление каталогов: нет прав.
281 Каталог не удален: внутренняя ошибка
282 Каталог не найден в аккаунте.
283 Неверный запрос, данные не переданы.
284 Неверный запрос, передан не массив.
285 Требуемое поле не передано.

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

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

Код Описание
405 Метод передачи запроса неверный
203 Добавление/Обновление элементов каталога: системная ошибка при работе с дополнительными полями
204 Добавление/Обновление элементов каталога: дополнительное поле не найдено
222 Добавление/Обновление/Удаление элементов каталога: пустой запрос
244 Добавление/Обновление/Удаление элементов каталога: нет прав.
280 Добавление элементов каталога: элемент создан.
282 Элемент не найден в аккаунте.
283 Неверный запрос, данные не переданы.
284 Неверный запрос, передан не массив.
285 Требуемое поле не передано.

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

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

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

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

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

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