AdCab
Справочник

Ошибки API Яндекс Директа

Директ отвечает на неудачный запрос кодом и короткой фразой вроде «Не поддерживается» — по ней редко понятно, что чинить. Здесь собраны коды, которые встречаются чаще всего, и разборы: в каких случаях приходит отказ и что поменять в запросе. Часть разборов получена живыми запросами к API — они отмечены отдельно.

КодЧто отвечает ДиректКогда приходит
53 Ошибка авторизации Директ не принял OAuth-токен: он истёк, отозван или выпущен для другого приложения.
54 Нет прав Аккаунт не агентский, а вызван агентский метод, либо у пользователя доступ только на чтение.
58 Незавершённая регистрация У логина нет доступа к API Директа: заявка не подана или не одобрена.
152 Недостаточно баллов Исчерпан суточный лимит баллов API. Каждый вызов стоит баллов, отчёты — дороже всего.
506 Превышено ограничение на количество одновременных соединений Слишком много параллельных запросов от одного аккаунта.
513 Ваш логин не подключён к Яндекс Директу У Яндекс-логина просто нет рекламного кабинета.
1000 Сервер временно недоступен Внутренняя ошибка на стороне Директа.
3500 Не поддерживается Операция или тип объекта закрыты для API.
3600 Ограниченная функциональность Возможность есть в API, но недоступна этому аккаунту.
4000 Параметры запроса указаны неверно Значение не того типа, неверный формат даты или часового пояса, недопустимое сочетание параметров.
4001 Неверно заданы параметры фильтрации SelectionCriteria Условие отбора противоречиво, пусто или превышает лимит идентификаторов.
5000 Поле обязательно для заполнения Не передано поле, обязательное для этого типа объекта.
5001 Превышена допустимая длина Текст длиннее лимита Директа.
5002 Используются недопустимые символы Запрещённый символ в ключевой или минус-фразе.
5005 Поле задано неверно Значение не подходит по смыслу: отрицательное число, неверный идентификатор, несуществующее значение перечисления.
6000 Неконсистентное состояние объекта Объекты не сочетаются друг с другом: тип группы не подходит типу кампании, условие — типу группы.
7000 Количество допустимых элементов превышено или равно нулю Массив пуст или в нём больше элементов, чем разрешено.
7001 Достигнуто максимальное количество объектов Упёрлись в лимит аккаунта: объявлений в группе, фраз в группе, кампаний в кабинете.
8000 Некорректный запрос Запрос не разобрался: невалидный JSON, отсутствует обязательный параметр, неизвестное значение перечисления.
8300 Неверный статус у объекта Операция невозможна в текущем состоянии объекта: он архивный, удалённый или остановленный.
8312 Отчёт невозможно построить в режиме online Отчёт слишком тяжёлый для мгновенного ответа.
8800 Объект не найден Идентификатор не существует или принадлежит другому кабинету.
9600 Поле не соответствует установленной стратегии Для выбранной стратегии обязательно поле, которого нет, либо передано лишнее.
9601 Не допускается изменение ставки Ставку задаёт автоматическая стратегия.
9800 Объект не может присутствовать в запросе более одного раза В массиве два элемента с одним идентификатором.

Остальные коды

Эти ошибки встречаются реже и обычно понятны по тексту. Если попадёте на такую и не разберётесь — напишите нам, добавим разбор.

КодЧто отвечает Директ
52Сервер авторизации временно недоступен
55Операция не найдена
1001Ошибка инициализации сервиса
1002Ошибка операции
1003Не удалось создать учётную запись пользователя на Яндексе
1004Не удалось создать клиента
1020Внутренняя ошибка сервера
3000Нет доступа к API
3001Нет доступа к методу
4002Неверно указаны параметры страницы
4003Не передано ни одного из необходимых параметров
4004Передан больше чем один параметр
4005В одном запросе необходимо использовать Id одного типа
4006В одном запросе заданы несовместимые операции
5003Указано пустое значение
5004Неверный формат
5006Неверное использование поля
5007Повторяющийся элемент
5008Не передано ни одного из необходимых полей
5009Передано больше чем одно поле
5010Некорректная длина поля
5100Неправильное использование шаблона
5120Геотаргетинг задан неправильно
5140Ключевая фраза содержит много слов
5141Некорректное использование стоп-слов
5142Превышена допустимая длина слова в ключевой фразе
5160Минус-слово не может быть словосочетанием
5161Некорректное использование минус-слов
5162Превышена допустимая длина минус-слова
5181Запрещено изменять рекламируемое приложение
5200Логин уже используется
6001Указан объект несоответствующего типа
6100Регион показа не соответствует тексту объявления
6101Язык не соответствует геотаргетингу
7002Данный домен трекинговой системы не поддерживается
8301Невозможно удалить объект
8302Невозможно остановить показы
8303Невозможно заархивировать объект
8304Невозможно разархивировать объект
8600Ошибка подключения общего счёта
9300Превышено ограничение на количество объектов в одном запросе
9301Слишком широкое условие отбора
9801Объект с указанными характеристиками уже существует
9802Элемент не может присутствовать в списке более одного раза

Чтобы не разбирать ошибки вручную

AdCab переводит отказы Директа на человеческий язык и не даёт отправить заведомо неверный запрос: лимиты, сочетания стратегий и поля отчётов проверяются до обращения к API.

Подключить бесплатно