AdPump — Коды ошибок API Яндекс Директа: 152, 53, 54, 513

Коды ошибок API Яндекс Директа — справочник с действиями.

Коротко: Разбор error_code в JSON.

← Каталог API Директа · Введение · Версии API · OAuth и доступ · Сервисы v5 · Лимиты и баллы · Ограничения · Кампании · Группы и объявления · Ключи и ставки · Минус-фразы и площадки · Отчёты · Песочница · Агентства · Примеры JSON · Автоматизация · Документация Яндекса

Содержание

Формат
Коды
HTTP vs JSON
Стратегия retry

Формат ошибки

{

  "error": {

    "error_code": 152,

    "error_string": "Quota exceeded",

    "error_detail": "Daily quota exceeded",

    "request_id": "abc123-def456-ghi789"

  }

}

Поле request_id — для обращения в поддержку Яндекса. Логируйте его вместе с запросом.

Справочник кодов ошибок

Код	Смысл	Действие
53	OAuth: недействительный токен	Обновить access_token через refresh_token
54	Нет прав доступа	Добавить Client-Login для агентства
55	Операция запрещена	Проверить Status/State сущности
152	Превышена квота баллов	Ждать обновления квоты
513	Неверный формат запроса	Валидация JSON, обязательные поля
1000	Внутренняя ошибка сервера	Повторить через 30–60 сек, exponential backoff
8800	Неверный IP-адрес	Добавить IP в whitelist OAuth-приложения
8000	Неизвестный метод	Проверить имя сервиса и method
5002	Объект не найден	Проверить Id в SelectionCriteria
6000	Ошибка модерации	Исправить объявление по замечаниям

HTTP-коды vs JSON error_code

Ситуация	HTTP	JSON error_code
Успех	200	—
Ошибка авторизации	200	53
Нет прав	200	54
Квота	200	152
Отчёт готовится	201/202	—
Серверная ошибка	500	1000

API v5 возвращает HTTP 200 даже при бизнес-ошибках — проверяйте поле error в теле ответа.

Стратегия повторных запросов

152 — ждать до полночи или backoff 60–300 сек.
1000 — exponential backoff: 30s, 60s, 120s (max 3 попытки).
Reports 201/202 — повтор через retry-in из заголовка.
53 — обновить токен, не повторять с тем же токеном.
513, 54, 55 — не повторять автоматически, исправить запрос.

Перейти в инструмент