Справочник ошибок и ответов 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” |
|
|||
ArturDoo
07.05.21 — 11:25 |
Как работает HTTPСоединение? Читал СП, там ничего дельного. |
||
Kassern
1 — 07.05.21 — 11:38 |
(0) я же тебе написал в прошлой ветке, что надо сделать |
||
Kassern
2 — 07.05.21 — 11:38 |
(1) передай в заголовках твой эксес токен |
||
ArturDoo
3 — 07.05.21 — 12:07 |
Обновлен ключ сессии, повторите запрос. Код состояния = 401
ЗначениеAccessToken = ПараметрыПодключения[Перечисления.ns_ВидыНастроекCRM.AccessToken]; |
||
Kassern
4 — 07.05.21 — 12:10 |
(3) AccessToken.Вставить(AccessToken, ЗначениеAccessToken); это как так то? ты в ключ пихаешь соответствие. И где ты прочитал в апишке, что ключ должен называться «AccessToken»? Я же тебе даже скинул в прошлой ветке какой ключ тебе нужен. |
||
ArturDoo
5 — 07.05.21 — 12:20 |
(4)Вод документация по контрагентам, там ни слова про атокен https://www.amocrm.com/developers/content/api_v4/contacts-api/ |
||
Kassern
6 — 07.05.21 — 12:32 |
(5) Наверное надо прочитать то, что до этого написано, например как работать по шагам и особенно обратить внимание на 5 шаг. А то что вы скинули, это уже после того, как получили токен и передали его в заголовки. |
||
Kassern
7 — 07.05.21 — 12:33 |
(5) откройте уже предыдущую тему и прочтите, что я вам написал |
||
Kassern
8 — 07.05.21 — 12:35 |
(7) Все же по русски написано: |
||
Kassern 9 — 07.05.21 — 12:37 |
(8) такое ощущение, что не вы писали аунтификацию для этого ресурса, а работаете с чьим что куском кода и пытаетесь его заставить работать на нужные вам методы. |
ВНИМАНИЕ! Если вы потеряли окно ввода сообщения, нажмите Ctrl-F5 или Ctrl-R или кнопку «Обновить» в браузере.
Тема не обновлялась длительное время, и была помечена как архивная. Добавление сообщений невозможно.
Но вы можете создать новую ветку и вам обязательно ответят!
Каждый час на Волшебном форуме бывает более 2000 человек.
При выполнении некорректного запроса к системе наше API может вернуть код ошибки, в случае же верного запроса, API вернёт ответ.
Вы, конечно, уже обрабатывали ответ сервера в ходе отладки своих виджетов или написании скриптов, взаимодействующих с нашей системой.
Для Вашего удобства, мы решили систематизировать все возможные ответы и ошибки, отдаваемые нашей системой и разместить их на отдельной странице.
Надеемся это облегчит и ускорит интеграцию Ваших проектов с amoCRM.
Ответы при авторизации
Подробнее об авторизации читайте здесь
CODE | HTTP CODE | ERROR | DESCRIPTION |
---|---|---|---|
110 | 401 Unauthorized | Неправильный логин или пароль | Общая ошибка авторизации. |
111 | 401 Unauthorized | Неправильный код капчи |
Возникает после нескольких неудачных попыток авторизации. В этом случае нужно авторизоваться в аккаунте через браузер, введя код капчи. |
112 | 401 Unauthorized | Пользователь не состоит в данном аккаунте |
Возникает, когда пользователь выключен в настройках аккаунта «Пользователи и права» или не состоит в аккаунте. |
113 | 403 Forbidden | Доступ к данному аккаунту запрещён с Вашего IP адреса |
Возникает, когда в настройках безопасности аккаунта включена фильтрация доступа к API по «белому списку IP адресов». |
101 | 401 Unauthorized | Account not found | Возникает в случае запроса к несуществующему аккаунту (субдомену). |
401 | 401 Not Authorized | 401 Unauthorized | На сервере нет данных аккаунта. Нужно сделать запрос на другой сервер по переданному IP. |
Ответы при работе с аккаунтом
Подробнее о работе с аккаунтом читайте здесь
CODE | DESCRIPTION |
---|---|
101 | Аккаунт не найден |
102 | POST-параметры должны передаваться в формате JSON |
103 | Параметры не переданы |
104 | Запрашиваемый метод API не найден |
Ответы при работе с контактами
Подробнее о работе с контактами читайте здесь
CODE | DESCRIPTION |
---|---|
201 | Добавление контактов: пустой массив |
202 | Добавление контактов: нет прав |
203 | Добавление контактов: системная ошибка при работе с дополнительными полями |
204 | Добавление контактов: дополнительное поле не найдено |
205 | Добавление контактов: контакт не создан |
206 | Добавление/Обновление контактов: пустой запрос |
207 | Добавление/Обновление контактов: неверный запрашиваемый метод |
208 | Обновление контактов: пустой массив |
209 | Обновление контактов: требуются параметры «id» и «last_modified» |
210 | Обновление контактов: системная ошибка при работе с дополнительными полями |
211 | Обновление контактов: дополнительное поле не найдено |
212 | Обновление контактов: контакт не обновлён |
219 | Список контактов: ошибка поиска, повторите запрос позднее |
Ответы при работе со сделками
Подробнее о работе со сделками читайте здесь
CODE | DESCRIPTION |
---|---|
213 | Добавление сделок: пустой массив |
214 | Добавление/Обновление сделок: пустой запрос |
215 | Добавление/Обновление сделок: неверный запрашиваемый метод |
216 | Обновление сделок: пустой массив |
217 | Обновление сделок: требуются параметры «id», «last_modified», «status_id», «name» |
240 | Добавление/Обновление сделок: неверный параметр «id» дополнительного поля |
Ответы при работе с событиями
Подробнее о работе с событиями читайте здесь
CODE | DESCRIPTION |
---|---|
218 | Добавление событий: пустой массив |
221 | Список событий: требуется тип |
222 | Добавление/Обновление событий: пустой запрос |
223 | Добавление/Обновление событий: неверный запрашиваемый метод (GET вместо POST) |
224 | Обновление событий: пустой массив |
225 | Обновление событий: события не найдены |
Ответы при работе с задачами
Подробнее о работе с задачами читайте здесь
CODE | DESCRIPTION |
---|---|
227 | Добавление задач: пустой массив |
228 | Добавление/Обновление задач: пустой запрос |
229 | Добавление/Обновление задач: неверный запрашиваемый метод |
230 | Обновление задач: пустой массив |
231 | Обновление задач: задачи не найдены |
232 | Добавление событий: ID элемента или тип элемента пустые либо неккоректные |
233 | Добавление событий: по данному ID элемента не найдены некоторые контакты |
234 | Добавление событий: по данному ID элемента не найдены некоторые сделки |
235 | Добавление задач: не указан тип элемента |
236 | Добавление задач: по данному ID элемента не найдены некоторые контакты |
237 | Добавление задач: по данному ID элемента не найдены некоторые сделки |
238 | Добавление контактов: отсутствует значение для дополнительного поля |
244 | Добавление сделок: нет прав. |
Другие ответы
Ошибки и ответы, не относящиеся к какому-либо конкретному разделу
CODE | DESCRIPTION | NOTE |
---|---|---|
400 | Неверная структура массива передаваемых данных, либо не верные идентификаторы кастомных полей | |
403 | Аккаунт заблокирован, за неоднократное превышение количества запросов в секунду | Вместе с этим ответом отдаётся HTTP код №403 |
429 | Превышено допустимое количество запросов в секунду | Вместе с этим ответом отдаётся HTTP код №429 |
2002 | По вашему запросу ничего не найдено | Вместе с этим ответом отдаётся HTTP код №204 «No Content» |
List of API error and API responses
When an incorrect request to the system is executed, our API can return an error code, in the case of the correct query, the API will return a response. You, of course, have already processed the server’s response while debugging your widgets or writing scripts interacting with our system. For your convenience, we decided to systematize all possible answers and errors, given by our system and place them on a separate page. We hope this will facilitate and accelerate the integration of your projects with Kommo.
Responses during authorization
Read more about authorization here
Error code | HTTP code | Description |
---|---|---|
110 | 401 Unauthorized | General authorization error. Incorrect login or password. |
111 | 401 Unauthorized | Occurs after several unsuccessful authorization attempts. In this case, you need to log in to your account through the browser by entering the captcha code. |
112 | 401 Unauthorized | Occurs when the user is turned off in the “Users and Rights” account settings or is not in the account. |
113 | 403 Forbidden | Access to this account is prohibited from your IP address. Occurs when the filtering of access to the API by the “whitelist of IP addresses” is enabled in the account security settings. |
101 | 401 Unauthorized | Occurs in the case of a request to a non-existent account (subdomain). |
401 | 401 Unauthorized | Not Authorized. There is no account information on the server. You need to make a request to another server on the transmitted IP. |
Responses while working with your account
For more information about working with your account, click here
Code | Description |
---|---|
101 | No account found |
102 | POST parameters must be sent in JSON format |
103 | Parameters not passed |
104 | The requested API method was not found |
Responses when working with contacts
For more information about working with contacts, click here.
Code | Description |
---|---|
201 | Adding Contacts: An Empty Array |
202 | Adding contacts: no rights |
203 | Adding contacts: system error when working with additional fields |
204 | Adding contacts: additional field not found |
205 | Adding contacts: no contact created |
206 | Add / Update contacts: empty query |
207 | Adding / Updating contacts: invalid method requested |
208 | Updating contacts: an empty array |
209 | Updating contacts: “id” and “updated_at” parameters are required |
210 | Updating contacts: system error when working with additional fields |
211 | Updating contacts: additional field not found |
212 | Updating contacts: contact not updated |
219 | Contact list: Search error, retry the request later |
Response when dealing with lead
More information about dealing with lead read here
Code | Description |
---|---|
213 | Adding Leads: An Empty Array |
214 | Adding / Updating deals: empty request |
215 | Adding / Updating leads: invalid method requested |
216 | Updating leads: empty array |
217 | Updating leads: the parameters “id”, “updated_at”, “status_id”, “name” ‘are required |
240 | Adding / Updating leads: invalid parameter “id” of an additional field |
Responses when working with events
Read more about working with events here
Code | Description |
---|---|
218 | Adding events: empty array |
221 | Event list: type required |
226 | Adding events: an event element of this entity could not be found |
244 | Adding events: insufficient rights to add an event |
222 | Adding / Updating Events: Empty request |
223 | Add / Update events: invalid method requested (GET instead of POST) |
224 | Event update: empty array |
225 | Event updates: no events found |
Responses when working with tasks
Read more about working with tasks here
Code | Description |
---|---|
227 | Adding Tasks: An Empty Array |
228 | Add / Update tasks: empty query |
229 | Adding / Updating Tasks: Invalid Method Requested |
230 | Updating tasks: an empty array |
231 | Update tasks: No tasks found |
232 | Adding events: The item ID or item type is empty or not valid |
233 | Adding events: some contacts have not been found for this item ID |
234 | Adding events: some transactions have not been found for this item ID |
235 | Adding Tasks: no element type specified |
236 | Adding Tasks: No contacts found for this Item ID |
237 | Adding Tasks: Some transactions were not found for this Item ID |
238 | Adding contacts: Missing value for additional field |
244 | Adding transactions: no rights. |
Responses when working with directories
Read more about working with directories here.
Code | Description |
---|---|
405 | Request Transfer Method Invalid |
222 | Adding / Updating / Deleting directories: an empty query |
244 | Adding / Updating / Deleting directories: No permissions. |
281 | Directory not deleted: internal error |
282 | The directory was not found in the account. |
283 | Invalid request, data not sent. |
284 | Invalid request, no array sent. |
285 | Required field not passed. |
Responses when working with directory elements
For more information about working with directory elements, see here
Code | Description |
---|---|
405 | Request Transfer Method is Invalid |
203 | Adding / Updating Directory Items: System Error with Custom Fields |
204 | Adding / Updating Directory Items: An additional field was not found |
222 | Adding / Updating / Deleting directory items: an empty request |
244 | Adding / Updating / Deleting directory items: insufficient rights |
280 | Adding directory items: element created. |
282 | Item not found in account. |
283 | Invalid request, data not sent. |
284 | Invalid request, no array passed. |
285 | Required field not submitted. |
Responses when working with customers
For more information about working with customers, see here
Code | Description |
---|---|
288 | Insufficient rights. Access is denied. |
402 | It is necessary to pay for the functional. |
425 | Functionality is not available. |
426 | Functionality is disabled. |
Other Responses
Errors and responses that do not relate to any particular section
Code | Description | Note |
---|---|---|
400 | Wrong structure of the array of transmitted data, or invalid identifiers of custom fields | |
402 | Subscription has ended | With this reply, you receive a HTTP code #402 “Payment Required” |
403 | The account is blocked, for repeatedly exceeding the number of requests per second. | Together with this response, HTTP code #403 |
429 | The number of requests per second exceeded | With the response, the HTTP code #429 is sent |
2002 | There are no results for your search | At the same time HTTP code #204 “No Content” is given with this response. |