Директ отвечает на неудачный запрос кодом и короткой фразой вроде «Не поддерживается» — по ней редко понятно, что чинить. Здесь собраны коды, которые встречаются чаще всего, и разборы: в каких случаях приходит отказ и что поменять в запросе. Часть разборов получена живыми запросами к 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.
Подключить бесплатно