Песочница API Яндекс Директа

Песочница API — безопасное тестирование интеграций.

Коротко: URL: https://api-sandbox.direct.yandex.com/json/v5/{service}.

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


Содержание

  1. URL
  2. Отличия
  3. Workflow
  4. Советы

URL песочницы

# Боевой:
POST https://api.direct.yandex.com/json/v5/campaigns

# Песочница:
POST https://api-sandbox.direct.yandex.com/json/v5/campaigns

# Отчёты в песочнице:
POST https://api-sandbox.direct.yandex.com/json/v5/reports

Документация песочницы.

Отличия от боевого API

ПараметрПесочницаБоевой
Реальные показыНетДа
Списание балловНетДа
МодерацияЭмуляцияРеальная
OAuth-токенТот жеТот же
Формат запросовИдентичен v5Идентичен v5

Workflow тестирования

  1. Получите OAuth-токен (OAuth).
  2. Выполните campaigns.get на https://api-sandbox.direct.yandex.com/json/v5.
  3. Создайте тестовую кампанию: campaigns.addadgroups.addads.add.
  4. Проверьте обработку ошибок (коды ошибок).
  5. Протестируйте Reports API в песочнице.
  6. Переключите URL на https://api.direct.yandex.com/json/v5 для боевого запуска.

Примеры JSON для копирования запросов.

Советы

  • В песочнице можно создавать любые сущности без риска расхода.
  • Используйте отдельный тестовый аккаунт Директа.
  • Не смешивайте sandbox URL и боевой в одном запросе.

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