Начните разрабатывать свое приложение

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

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

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

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

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

В качестве тестового пользователя вы можете использовать свой аккаунт разработчика. Вы также можете создать отдельного тестового пользователя, повторив для него описанные выше шаги 1.11.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"
Совет.

Столкнулись с трудностями? Рекомендуем пройти обучающий курс Как начать работать с API Яндекc.Директа.

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

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

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

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

Об изменениях в API Директа мы сообщаем в официальном блоге. Чтобы получать уведомления о новых постах, подпишитесь.