Обработка ошибок

Если сервер не сможет обработать запрос, заголовок HTTP invocation-error будет содержать код ошибки. Кроме того, ответ содержит подробную информацию в формате XML или JSON.

Коды ошибок:

ИмяКодОписание
UNKNOWN1Неизвестная ошибка
SERVICE2Сервис временно недоступен
METHOD3Метод не существует
REQUEST4Не удалось обработать запрос, так как он неверный
ACTION_BLOCKED7Запрошенное действие временно заблокировано для текущего пользователя
FLOOD_BLOCKED8Выполнение метода заблокировано вследствие флуда
IP_BLOCKED9Выполнение метода заблокировано по IP-адресу вследствие подозрительных действий текущего пользователя или вследствие прочих ограничений, распространяющихся на конкретный метод
PERMISSION_DENIED10Отказ в разрешении. Возможная причина - пользователь не авторизовал приложение на выполнение операции.
LIMIT_REACHED11Достигнут предел вызовов метода
CANCELLED12Операция прервана пользователем
NOT_MULTIPART21Не multi-part запрос при добавлении фотографий
NOT_ACTIVATED22Пользователь должен активировать свой аккаунт
NOT_YET_INVOLVED23Пользователь не вовлечён в приложение
NOT_OWNER24Пользователь не является владельцем объекта
NOT_ACTIVE25Ошибка рассылки нотификаций. Пользователь неактивен в приложении.
TOTAL_LIMIT_REACHED26Ошибка рассылки нотификаций. Достигнут лимит нотификаций для приложения.
NOT_ADMIN50У пользователя нет административных прав для выполнения данного метода
PARAM100Отсутствующий или неверный параметр
PARAM_API_KEY101Параметр application_key не указан или указан неверно
PARAM_SESSION_EXPIRED102Истек срок действия ключа сессии
PARAM_SESSION_KEY103Неверный ключ сессии
PARAM_SIGNATURE104Неверная подпись
PARAM_RESIGNATURE105Неверная повторная подпись
PARAM_ENTITY_ID106Неверный идентификатор дискуссии
PARAM_USER_ID110Неверный идентификатор пользователя
PARAM_ALBUM_ID120Неверный идентификатор альбома
PARAM_PHOTO_ID121Неверный идентификатор фотографии
PARAM_WIDGET130Неверный идентификатор виджета
PARAM_MESSAGE_ID140Неверный идентификатор сообщения
PARAM_COMMENT_ID141Неверный идентификатор комментария
PARAM_HAPPENING_ID150Неверный идентификатор события
PARAM_HAPPENING_PHOTO_ID151Неверный идентификатор фотографии события
PARAM_GROUP_ID160Неверный идентификатор группы
PARAM_PERMISSION200Приложение не может выполнить операцию. В большинстве случаев причиной является попытка получения доступа к операции без авторизации от пользователя.
PARAM_APPLICATION_DISABLED210Приложение отключено
PARAM_DECISION211Неверный идентификатор выбора
PARAM_BADGE_ID212Неверный идентификатор значка
PARAM_PRESENT_ID213Неверный идентификатор подарка
PARAM_RELATION_TYPE214Неверный идентификатор типа связи
NOT_FOUND300Информация о запросе не найдена
EDIT_PHOTO_FILE324Ошибка обработки multi-part запроса
AUTH_LOGIN401Сбой аутентификации. Неверное имя пользователя/пароль или маркер аутентификации или пользователь удален/заблокирован.
AUTH_LOGIN_CAPTCHA402Сбой аутентификации. Требуется ввести капчу для проверки пользователя.
AUTH_LOGIN_WEB_HUMAN_CHECK403Сбой аутентификации
NOT_SESSION_METHOD451Указан ключ сессии, но метод должен быть вызван вне сессии
SESSION_REQUIRED453Ключ сессии не указан для метода, требующего сессии
CENSOR_MATCH454Текст отклонен цензором
FRIEND_RESTRICTION455Невозможно выполнить операцию, так как друг установил на нее ограничение (поместил в «черный список» или сделал свой аккаунт приватным)
GROUP_RESTRICTION456Невозможно выполнить операцию, так как группа установила на нее ограничение
UNAUTHORIZED_RESTRICTION457Неавторизованный доступ
PRIVACY_RESTRICTION458То же что и FRIEND_RESTRICTION
PHOTO_SIZE_LIMIT_EXCEEDED500Размер двоичного содержимого изображения в байтах превышает предел
PHOTO_SIZE_TOO_SMALL501Слишком маленький размер изображения в пикселях
PHOTO_SIZE_TOO_BIG502Слишком большой размер изображения в пикселях
PHOTO_INVALID_FORMAT503Невозможно распознать формат изображения
PHOTO_IMAGE_CORRUPTED504Формат изображения распознан, но содержимое повреждено
PHOTO_NO_IMAGE505В запросе не найдено изображение
PHOTO_PIN_TOO_MUCH508Слишком много отметок на фотографии
IDS_BLOCKED511Ошибка проверки антиспама
PHOTO_ALBUM_NOT_BELONGS_TO_USER512Попытка залить фотографию в чужой альбом
PHOTO_ALBUM_NOT_BELONGS_TO_GROUP513Попытка залить фотографию в альбом, не принадлежащий указанной группе
MEDIA_TOPIC_BLOCK_LIMIT600Слишком много параметров “медиа”
MEDIA_TOPIC_TEXT_LIMIT601Достигнут лимит длины текста
MEDIA_TOPIC_POLL_QUESTION_TEXT_LIMIT602Достигнут лимит длины текста вопроса к голосованию
MEDIA_TOPIC_POLL_ANSWERS_LIMIT603Слишком много ответов к голосованию
MEDIA_TOPIC_POLL_ANSWER_TEXT_LIMIT604Достигнут лимит длины текста ответа к голосованию
MEDIA_TOPIC_WITH_FRIENDS_LIMIT605Достигнут лимит количества отмечаемых друзей
MEDIA_TOPIC_WITH_FRIENDS_USER_LIMIT606Достигнут лимит количества отмечаемых друзей (юзер-специфик)
GROUP_DUPLICATE_JOIN_REQUEST610Запрос на вступление в группу, уже зарегистрирован
COMMENT_NOT_FOUND700Комментарий не найден
INVALID_AUTHOR701Попытка отредактировать комментарий, не принадлежащий пользователю
COMMENT_NOT_ACTIVE702Попытка отредактировать удалённый комментарий
TIMEOUT_EXCEEDED704Время редактирования истекло
CHAT_NOT_FOUND705Чат не найден
MESSAGE_NOT_ACTIVE706Попытка отредактировать удалённое сообщение
NO_SUCH_APP900Возвращается при попытке получить открытую информацию для несуществующего приложения
CALLBACK_INVALID_PAYMENT1001Ошибка возвращена сервером приложений для уведомления о неверной информации транзакции
PAYMENT_IS_REQUIRED_PAYMENT1002Для использования сервиса необходима оплата
INVALID_PAYMENT1003Неверная платежная транзакция
DUPLICATE_PAYMENT1004Слишком частые запросы платежа
NOT_ENOUGH_MONEY1005У пользователя недостаточно денег на аккаунте
VCHAT_SERVICE_DISABLED1101Видео-чат отключен
TARGET_USER_UNAVAILABLE1102Пользователь недоступен для видео-чата или видео-сообщения
FRIENDSHIP_REQUIRED1103Указанный пользователь должен быть другом
BATCH1200Ошибка вызова батчинга
APP_NO_PLATFORM_ALLOWED1300Платформы для приложения не установлены
APP_DEVICE_NOT_ALLOWED1301Указанное устройство не доступно
APP_DEVICE_NOT_SPECIFIED1302Устройство не указано
APP_EMPTY_SEARCH_PARAMS1400Ошибка поиска мест
APP_SEARCH_SCENARIO_DOES_NOT_EXIST1401Ошибка поиска мест
SYSTEM9999Критическая системная ошибка. Оповестите об этом службу поддержки

Дополнительные коды для ошибки 100 “неверный параметр”

Возвращаются в поле error_data, поле error_field в этом случае содержит имя ошибочного параметра.

ИмяКодОписание
NOT_NULL1Параметр должен быть указан
NOT_EMPTY2Параметр должен быть не пустым
IS_EMPTY3Параметр должен быть пустым
MAX_ELEMENTS4Ограничение на кол-во элементов
MIN_LENGTH5Параметр слишком короткий
MAX_LENGTH6Параметр слишком длинный
MIN_VALUE7Значение параметра слишком маленькое
MAX_VALUE8Значение параметра слишком большое
RANGE9Значение параметра должно быть в указанном промежутке

Примеры

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:error_response xmlns:ns2="http://api.forticom.com/1.0/">
     <error_code>101</error_code>
     <error_msg>PARAM_API_KEY : No application key</error_msg>
</ns2:error_response>
{
    "error_code" : 100,
    "error_msg" : "PARAM : Either session_key or uid must be specified",
    "error_data" : "1",
    "error_field" : "uid"
}