Быстрый старт

Регистрация приложения

1. Создайте аккаунт в Директе, который будете использовать как разработчик приложений:

   1. Если у вас нет логина на Яндексе — зарегистрируйтесь.

   2. В веб-интерфейсе Директа создайте аккаунт: укажите актуальный адрес электронной почты, выберите страну и валюту, нажмите кнопку Начать пользоваться сервисом.

   3. На странице Настройки API нажмите ссылку Получить доступ к API и примите пользовательское соглашение.

2. Зарегистрируйте свое приложение на сервисе Яндекс ID.

3. Создайте заявку на получение тестового доступа для вашего приложения. Дождитесь одобрения заявки.

Отладка на тестовых данных

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

1. От имени тестового пользователя получите отладочный OAuth-токен.
2. Включите Песочницу — среду для отладки приложения, где можно управлять тестовыми кампаниями без реальных показов и внесения средств.
3. Выполняйте запросы к Песочнице методом HTTP POST, используя отладочный токен. Пример запроса:

   curl \
    -H 'Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f' \
    -H 'Accept-Language: en' \
    -d '
      {
        "method":"get",
        "params": {
          "SelectionCriteria": {},
          "FieldNames": [
            "Name",
            "DailyBudget",
            "Funds",
            "Statistics",
            "Type"
          ],
          "TextCampaignFieldNames": [
            "CounterIds",
            "RelevantKeywords",
            "Settings",
            "BiddingStrategy"
          ]
        }
      }' \
    "https://api-sandbox.direct.yandex.com/json/v5/campaigns"
   

Переход к работе с данными реальных пользователей

1. Реализуйте в приложении удобный для пользователей механизм получения токена.

2. Переведите заявку на тестовый доступ в заявку на полный доступ. Дождитесь одобрения заявки.

3. Замените в приложении адреса Песочницы на основные адреса. Адрес каждого сервиса указан в его описании.