---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.2
alternate:
  - https://yandex.ru/dev/telemost/doc/ru/access.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/telemost/doc/ru/llms.txt

# Доступ к API

Яндекс Телемост авторизует приложения с помощью [OAuth-токенов](https://yandex.ru/dev/oauth/doc/dg/concepts/ya-oauth-intro.html). Чтобы использовать протокол OAuth при работе Телемостом:


1. Создайте свое OAuth-приложение по [инструкции](https://yandex.ru/dev/id/doc/ru/register-api) из Справки OAuth Яндекс ID. В разделе **Доступ к данным** укажите необходимые права доступа из тех, которые используются в API Яндекс 360 для бизнеса:

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

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

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

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

3. Получите OAuth-токен: {#token}

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

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

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

   2. Если токен вашему приложению выдается впервые или срок жизни предыдущего токена истек, откроется экран авторизации. Войдите в сервис.
   3. Скопируйте значение токена с открывшейся страницы и сохраните его. 
      
      {% note info "Вы не сможете найти полученный токен в личном кабинете" %}
      
      Сервис Яндекс OAuth не хранит выдаваемые токены в публичном доступе. Если вы не сохранили токен, вы можете получить его еще раз.
      
      {% endnote %}

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

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

Полную информацию об OAuth-авторизации и токенах читайте в [документации OAuth-сервиса Яндекса](https://yandex.ru/dev/id/doc/ru/).