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

Об ошибке при обработке запроса свидетельствует наличие тега error в ответе. В таком случае необходимо исправить запрос и повторить его.

Пример ответа с ошибкой:

  • в виде простой структуры

    <response>
      <status>
        <code>-2</code>
        <error>Access denied</error>
      </status>
    </response>
  • с дополнительной информацией о некорректном параметре

    <response>
      <status>
        <code>-6</code>
        <error>Incorrect value</error>
        <parameter>encoding</parameter>
        <value>123</value>
      </status>
    </response>

Существует вариант частичного выполнения запроса, в таком случае ответ будет содержать тег <code>0</code> и тег message с описанием той части запроса, которая не была выполнена.

Расшифровка кодов ошибок приведена в таблице:

Код ошибки (code) Ошибка (error) Расшифровка
-1 Authorization failed Ошибка авторизации — проверьте правильность логина и пароля. Пароль требуется передавать в виде значения хеш-функции sha256 от пароля пользователя.
-2 Access denied Доступ к объекту запрещен — у вас недостаточно прав для доступа к объекту.
-3 Invalid object name Неправильный object — проверьте название контекста.
-4 Invalid action object name Неправильный actionObject — проверьте имя объекта, над которым производится действие.
-5 Invalid action name Неправильный action — проверьте название действия.
-6 Incorrect value Неправильное значение параметра — проверьте значение параметра.
-7 Value required Не задан обязательный параметр — проверьте наличие обязательных параметров в запросе.
-8 Account already exists Аккаунт уже существует (ошибка выводится при создании/переименовании аккаунтов). Попробуйте задать другое имя аккаунта.
-9 Value must be not NULL Параметр не может быть пустым — укажите значение параметра.
-10

Предупреждение при включении/выключении размещения:

This object is placed upper Объект включен в размещении уровнем выше.
This object is unplaced upper Объект выключен в размещении уровнем ниже.
-11 Error file uploading Ошибка загрузки файла.
-100 Превышен максимально допустимый размер файла.
-101 Неправильный MIME-тип.
-102 Внутренняя ошибка.
-103 Внутренняя ошибка.
-200 Не удалось загрузить файл по указанному URL.
-12 Value is out of length Превышена максимально допустимая длина строки значения параметра
-14 Duplicate entry Такой идентификатор значения дополнительной характеристики или точки учета действия уже используется — укажите другое значение для параметра userID .
-15 Invalid type

Указан неверный объект размещения для баннера — значение параметра type не соответствует объекту размещения.

Например, type=adNetwork&_site676=on.

В таком случае логика размещения указана для рекламной сети, но в запросе передаются данные объекта сайт. Необходимо исправить несоответствие.

-16 Type required Не указан обязательный параметр type для настройки размещения баннера — добавьте в запрос параметр type, определяющий логику настройки размещения: на сайте или на рекламной сети.
-99 Multiple errors При добавлении баннера по умолчанию для типа баннера или площадки не было указано значение для параметра «URL изображения»(defaultImageURL) или «URL для перехода» (defaultHitURL).
-667 Logon errors limit reached Достигнут лимит ошибок авторизации — произведено 7 некорректных попыток за последние 5 минут. Необходимо проверить авторизационные данные и повторить попытку через 10 минут.
-999 Http is not allowed Этот тип запроса не может быть выполнен по протоколу HTTP. Повторите запрос по протоколу HTTPS.
-1000 Password is inactive. Create new password. Пароль неактивен. Создать новый пароль.

В ответе вернется дополнительно тег <secure_token></secure_token>, содержащий 33-х символьный код , необходимый для создания нового пароля.

-1001 Password is not secure. Пароль небезопасный — смотрите требования к паролю.
-1002 You can not use your current password. Вы не можете использовать текущий пароль. Придумайте новый пароль.
-1003 The password must be at least 8 characters. Пароль должен содержать не менее 8 символов.
-1004 Password recovery required. Текущий пароль не действителен — перейдите на страницу восстановления пароля для данного аккаунта.
-1415 Daily amount of views should be set. Установите суточное количество показов.
-1416 Daily amount of clicks should be set. Установите суточное количество переходов.
-1420 Cumulative amount of views should be set. Установите общее количество показов.
-1420 Cumulative amount of clicks should be set. Установите общее количество переходов.
-1500 Only marked as "For insertion code with loader.js" banners can be added in campaign with Impression method "Viewable impression". В кампанию с методикой подсчета показов по «Видимому показу» могут быть добавлены баннеры только с шаблонами, имеющими отметку «Для кода вставки с loader.js».
-1501 Banners do not match the campaign, or they are deleted. В указанной кампании не найдены баннеры для копирования или они были удалены. Проверьте значения для параметров objectID и listIDs.
-1502 Only banners with templates marked as "For insertion code with loader.js" is allowed to add in this campaign. В кампанию с методикой подсчета показов по «Видимому показу» могут быть скопированы баннеры только с шаблонами, имеющими отметку «Для кода вставки с loader.js».
-1504 Campaign kind is not dynamic allocation. Невозможно установить CPM, так как рекламная кампания не относится к виду «Динамическая монетизация». Измените вид кампании и повторите изменение CPM.
-1505 Dynamic allocation is not enabled. В аккаунте не подключен модуль «Динамическая монетизация». Обратитесь в службу технической поддержки с запросом на подключение модуля.
-1506 CPM is blocked in system campaigns. Изменить CPM для системной рекламной кампании невозможно. Проверьте идентификатор кампании, для которой производите изменения.
-1507 To change the CPM, you need to wait 5 minutes. Please wait 5 minutes. Повторите запрос на изменение CPM через 5 минут.
-1508 Incorrect JSON format in "blocks" field. Некорректное описание JSON-значения или отсутствие параметра blocks в логическом таргетировании. Проверьте синтаксис и повторите запрос.
-1516 Can not copy campaigns or banners with external monetization Кампании и баннеры, созданные для внешних монетизаторов (например, criteo, Soloway, mytarget и другие), не могут быть скопированы. Также запрещено копирование баннеров из РК для монетизаторов.
-2000 Advertiser is not assigned for current assistant. Ассистент не может работать с данным рекламодателем. Необходимо либо изменить настройки прав ассистента, либо создать кампанию с рекламодателем, который доступен ассистенту.
-10105 Unsupported archive type. Неподдерживаемый тип архива. Используйте только zip архив.
-10105 Too long html field. HTML-код не должен превышать 65000 символов.
-10101 File size limit reached. По умолчанию максимальный размер файла: 300Кб, для видео - 1Мб.
-10103 Wrong file type. Неверный тип файла в архиве. Разрешенные типы файлов: css, js, html, gif, png, jpg, jpeg, svg, json, flv, mp4, ogv, ogg, webm, avi, swf, otf, ttf, abf, acfm, gdr, etx, eot, fnt, fon, mf, ttc, woff.
-10104 Wrong file name. Названия файлов должны содержать только цифры или буквы английского алфавита, символ подчёркивания. Не допускается использование в названии файла русских букв, пробелов, кавычек, тире и специальных символов.
-10106 Must be one html file in archive. В архиве может находиться только один файл с расширением html.
-10108 Files depth limit reached. Превышена глубина вложенности файлов. Максимальный уровень вложенности - 2.