Доступ к API

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

1. Создайте свое OAuth-приложение по инструкции из Справки OAuth Яндекс ID. В разделе Доступ к данным укажите необходимые права доступа из тех, которые используются в API Яндекс 360 для бизнеса:

   • создание встреч и трансляций — telemost-api:conferences.create;
   • просмотр данных о встречах и трансляциях — telemost-api:conferences.read;
   • изменение данных о встречах и трансляциях — telemost-api:conferences.update;
   • просмотр настроек по умолчанию для всех создаваемых видеовстреч и трансляций — telemost-api:organization_settings.read;
   • изменение настроек по умолчанию для всех создаваемых видеовстреч и трансляций — telemost-api:organization_settings.update.

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

3. Получите OAuth-токен:

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

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

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

   2. Если токен вашему приложению выдается впервые или срок жизни предыдущего токена истек, откроется экран авторизации. Войдите в сервис.

   3. Скопируйте значение токена с открывшейся страницы и сохраните его.

      Вы не сможете найти полученный токен в личном кабинете

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

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

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

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