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

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

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

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

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

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

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

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

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

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