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