Доступ к API

Яндекс Телемост авторизует приложения с помощью OAuth-токенов. Чтобы использовать протокол OAuth при работе Телемостом:

1. Зарегистрируйте свое OAuth-приложение:

   1. Авторизуйтесь на Яндексе.

   2. Откройте страницу создания приложения.

   3. Укажите название вашего сервиса и при необходимости прикрепите иконку.

   4. Выберите платформы, на которых будет работать ваше приложение, и укажите их параметры.

      Если вы разрабатываете или тестируете приложение, используйте отладочный токен. Для получения такого токена выберите Веб-сервисы и в поле Redirect URI подставьте значение по умолчанию, которое появится в подсказке Подставить URL для отладки: https://oauth.yandex.ru/verification_code.

   5. В разделе Доступ к данным укажите необходимые права доступа:

      • Создание встреч и трансляций в Телемосте — telemost-api:conferences.create;

      • Просмотр данных о встречах и трансляциях в Телемосте — telemost-api:conferences.read;

      • Редактирование данных о встречах и трансляциях в Телемосте — telemost-api:conferences.update;

      • Удаление встреч и трансляций в Телемосте — telemost-api:conferences.delete.

   6. Укажите электронную почту для связи.

   7. Внизу страницы нажмите кнопку Создать приложение. На экране появится его описание.

   8. Скопируйте идентификатор приложения из поля ClientID — он потребуется для получения OAuth-токена. В дальнейшем открыть страницу со всеми вашими приложениями вы сможете по ссылке oauth.yandex.ru.

2. Получите OAuth-токен одним из доступных способов.

   Отладочный токен необходимо получить вручную:

   1. Перейдите по ссылке

      https://oauth.yandex.ru/authorize?response_type=token&client_id=<идентификатор_приложения>
      

      Вместо <идентификатор_приложения> подставьте значение ClientID из пункта 1.8.

   2. Если токен вашему приложению выдается впервые, откроется экран авторизации. После входа Яндекс OAuth перенаправит вас на страницу с токеном. Подробнее об отладочных токенах.

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

--header 'Authorization: OAuth <OAuth-токен>'

Подробнее об OAuth-авторизации читайте в документации OAuth-сервиса Яндекса.