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

Об ошибке при обработке запроса свидетельствует наличие тега 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

Доступ к объекту запрещен — у вас недостаточно прав для доступа к объекту.

-2

Change targeting by URL is not allowed

У вас нет доступа на редактирование таргетирования по URL.

-3

Invalid object name

Неправильный object — проверьте название контекста.

-4

Invalid action object name

Неправильный actionObject — проверьте имя объекта, над которым производится действие.

-5

Invalid action name

Неправильный action — проверьте название действия.

-6

Incorrect value

Неправильное значение параметра — проверьте значение параметра.

-6

Type 3 is not allowed

Для параметра templateType задан неверный тип шаблона URL.

-6

Maximum allowed referrers 5

Превышено количество строк шаблона для targetingUrlOn или targetingUrlOff. Допускается максимум 5 строк.

-6

Value for 'placeId' is required

Не указан или равен 0 параметр placeID, siteID или zoneID.

-7

Value required

Не задан обязательный параметр — проверьте наличие обязательных параметров в запросе.

-8

Account already exists

Аккаунт уже существует (ошибка выводится при создании/переименовании аккаунтов). Попробуйте задать другое имя аккаунта.

-9

Value must be not NULL

Параметр не может быть пустым — укажите значение параметра.

-10

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

-10

This object is placed upper

Объект включен в размещении уровнем выше.

-10

This object is unplaced upper

Объект выключен в размещении уровнем ниже.

-11

Error file uploading

Ошибка загрузки файла. Некорректно переданы ссылки на медиаданные. В теге будет указан URL, по которому не удалось загрузить данные.

-12

Value is out of length

Превышена максимально допустимая длина строки значения параметра

-14

Duplicate entry

Такой идентификатор значения дополнительной характеристики или точки учета действия уже используется — укажите другое значение для параметра userID.

-15

Invalid type

Некорректный тип данных:

  • если вместо массива передан другой объект (например, строка для ОКВЭД-ов вместо массива);
  • некорректный JSON для медиаданных.

В тег <parameter> будет добавлено название параметра, в тег <value> — его значение. Также в ответе будут указаны максимальное и минимальное значение.

-16

Type required

Не указан обязательный параметр type для настройки размещения баннера — добавьте в запрос параметр type, определяющий логику настройки размещения: на сайте или на рекламной сети.

-99

Multiple errors

При добавлении баннера по умолчанию для типа баннера или площадки не было указано значение для параметра «URL изображения»(defaultImageURL) или «URL для перехода» (defaultHitURL).

-100

Превышен максимально допустимый размер файла.

-101

Неправильный MIME-тип.

-102

Внутренняя ошибка.

-103

Внутренняя ошибка.

-200

Не удалось загрузить файл по указанному URL.

-667

Logon errors limit reached

Достигнут лимит ошибок авторизации — произведено 7 некорректных попыток за последние 5 минут. Необходимо проверить авторизационные данные и повторить попытку через 10 минут.

-680

Connection limit reached

Превышено максимальное количество одновременно работающих запросов. Повторите этот запрос позже.

-999

Http is not allowed

Этот тип запроса не может быть выполнен по протоколу HTTP. Повторите запрос по протоколу HTTPS.

-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 context.js" banners can be added in campaign with Impression method "Viewable impression, 2 seconds".

В кампанию с методикой подсчета показов по «Видимому показу, 2 сек» могут быть добавлены баннеры только с шаблонами, имеющими в названии тег [context].

-1501

Banners do not match the campaign, or they are deleted

В указанной кампании не найдены баннеры для копирования или они были удалены. Проверьте значения для параметров objectID и listIDs.

-1502

Only banners with templates marked as "For insertion code with context.js" is allowed to add in this campaign

В кампанию с методикой подсчета показов по «Видимому показу, 2 сек» могут быть скопированы баннеры только с шаблонами, имеющими в названии тег [context].

-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

Ассистент не может работать с данным рекламодателем. Необходимо либо изменить настройки прав ассистента, либо создать кампанию с рекламодателем, который доступен ассистенту.

-2500

You should use IMS template in IMS campaign

При создании баннера в кампанию с методикой учета показов по IMS необходимо использовать IMS шаблоны. Получите список шаблонов для типа баннера и убедитесь, что в шаблоне включен IMS (isIms=1).

-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

Названия файлов должны содержать только цифры или буквы английского алфавита, символ подчеркивания. Не допускается использование в названии файла русских букв, пробелов, кавычек, тире и специальных символов.

-10105

Too long html field

HTML-код не должен превышать 65000 символов.

-10105

Unsupported archive type

Неподдерживаемый тип архива. Используйте только zip архив.

-10106

Must be one html file in archive

В архиве может находиться только один файл с расширением html.

-10108

Files depth limit reached

Превышена глубина вложенности файлов. Максимальный уровень вложенности ― 2.

-20000

You need to specify the creative data

Данные о креативах не переданы или по переданным параметрам не удалось получить данные (например, указаны креативы шаблона, в которых нет данных).

-20001

The advertising campaign is not marked

Невозможно включить маркировку на баннере, так как она отключена на рекламной кампании.

-20002

The contract not found

Договор не найден.

-20003

The customer not found

Заказчик не найден.

-20004

The executor not found

Исполнитель не найден.

-20005

The intermediary contract not found

Родительский контракт не найден.

-20006

The customer and the executor cannot be the same contractor

Заказчик и исполнитель не могут быть одним контрагентом.

-20007

Intermediary contract id can not be empty

Для данного договора должен быть указан идентификатор родительского договора.

-20008

The contract can not be deleted because it is linked to a campaign

Невозможно удалить договор, так как он привязан к кампании.

-20009

The contract can not be deleted because it is linked to a supercampaign

Невозможно удалить договор, так как он привязан к суперкампании.

-20010

The contract can not be deleted, because it has an additional agreement associated with it

Невозможно удалить договор, так как есть связанное с ним дополнительное соглашение.

-20011

Can not delete role "Executor". There are sites associated with this executor

Невозможно удалить роль "Исполнитель". Имеются связанные с данным контрагентом сайты.

-20012

Can not delete role "Executor". There are contracts associated with this executor

Невозможно удалить роль "Исполнитель". Имеются связанные с данным контрагентом договоры.

-20013

Can not delete role "Customer". There are contracts associated with this customer

Невозможно удалить роль "Заказчик". Имеются связанные с данным контрагентом договоры.

-20014

The contractor can not be deleted because it is linked to a contracts

Нельзя удалить контрагента с которым есть действующие контракты.

-20015

The contractor can not be deleted because it is linked to a sites

Нельзя удалить контрагента. Имеются связанные с ним сайты.

-20040

INN is duplicated

Контрагент с таким ИНН уже существует.

-20042

Incorrect conclusion date (the date must be greater than 1991.01.01 and not older than the current date)

Некорректная дата договора/дополнительного соглашения. Дата должна быть не раньше 1991.01.01 и не позднее текущей даты.

-20050

Token field is not allowed when sendToErir=1

Вы можете передать сторонний токен только при выключенной передаче данных в ЕРИР. Если параметр sendToErir=1, то в креативе будет сгенерирован собственный токен.

-20051

Invalid third-party token (letters and numbers only allowed)

Некорректный сторонний токен (разрешены только буквы латинского алфавита и цифры).

Предыдущая