Доступ к API

Для успешного вызова API необходимы:
  • Корректные заголовки Accept и Content-Type: API Дисплея поддерживает только два MIME-типа, application/json и application/xml. Любое другое значение приведет к ошибке формата данных.
  • URL, составленный согласно требованиям к нужному запросу.
  • OAuth-токен, выданный вашему приложению.

Общие правила для составления URL

Правила, общие для всех ресурсов:
  • Хост для всех запросов к API — https://rest-api.display.yandex.net/rest.
  • В каждом запросе необходимо указывать версию API.

OAuth-токен

Яндекс.Дисплей авторизует приложения с помощью OAuth-токенов. Каждый токен предоставляет определенному приложению доступ к данным конкретного пользователя.

Получение OAuth-токена

Чтобы использовать протокол OAuth при работе с сервисом Яндекса, вам нужно зарегистрировать свое приложение.

После регистрации приложение сможет получать OAuth-токены для доступа к данным пользователей в Дисплее.

Использование токена

Полученный токен необходимо передавать при каждом вызове API Дисплея в HTTP-заголовке Authorization с указанием типа OAuth:
Authorization: OAuth e78cf1a0ebbb19...