Возвращаемые коды и статусы

Мы обновили документацию, актуальная версия страницы доступна по ссылке: Возвращаемые коды и статусы

В данном разделе представлены коды и статусы, которые возвращает сервер API, а также описание их значений.

Коды успешных запросов

Метод запросаКод успешного выполнения
GET200
POST201
PUT200
DELETE204

Коды и статусы ошибок запроса

В случае ошибки запроса, в ответ возвращается сообщение с кодом 4XX. Дополнительно в ответе может присутствовать поле status, содержащее значение, по которому можно различать ошибки с одинаковым кодом.

КодСтатусОписание
401
Пользователь не авторизован. Токен доступа не передается в запросе, либо токен доступа просрочен или некорректен. См. авторизация приложений
403access_deniedДанный пользователь не обладает правом доступа на запрашиваемый ресурс
403user_blockedДанный пользователь либо клиент, к которому относится пользователь, заблокирован
403user_access_type_denyНедостаточный уровень доступа пользователя
403app_access_type_denyНедостаточный для данного ресурса уровень доступа приложения. См. создание приложений
404
Ресурс не существует
404client_not_foundКлиент с переданным в пути ID не найден
404extension_not_foundДобавочный с переданным в пути ID не найден
405
Ресурс не поддерживает данный метод запроса
413
Размер тела запроса больше допустимого (10 МБ)
413large_fileРазмер загружаемого файла больше допустимого для данного ресурса
429rate_limit_exceededПревышен лимит на количество API-запросов. См. лимиты запросов
400limit_exceededПревышен лимит на количество ресурсов создаваемого типа. См. лимиты
400input_errorНеверный форма одного из аргументов, передаваемых в теле запроса, либо отсутствие одного из обязательных аргументов.
400wrong_extension_typeПопытка использование ресурса, который не относится к данному типу добавочного
400wrong_fileНеверный формат загружаемого файла
400unresolvable_meПрименение идентификатора ресурса @me для данного пользователя и ресурса невозможно
400no_recordsВ запрашиваемом диапазоне дат нет записей для формирования архива записей разговора
400records_size_too_largeРазмер записей разговора запрашиваемом диапазоне дат больше максимально разрешенного для формирования архива. Следует выбрать меньший диапазон дат.
400archive_already_requestedАрхив записей разговора для данного клиента уже был запрошен. Повторный запрос архива возможен только после загрузки предыдущего архива.
400email_duplicateПереданный в качестве параметра email-адрес уже использован
400already_existsСоздаваемый ресурс уже существуют