---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://yandex.ru/dev/telemost/doc/ru/access.md
  - href: https://yandex.ru/dev/telemost/doc/ru/access.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/telemost/doc/ru/llms.txt?revision=r21934284
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/telemost/doc/ru/llms.txt?revision=r21934284

# Доступ к 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`;
    - просмотр настроек по умолчанию для всех создаваемых видеовстреч и трансляций — `telemost-api:organization_settings.read`;
    - изменение настроек по умолчанию для всех создаваемых видеовстреч и трансляций — `telemost-api:organization_settings.update`.

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

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

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

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

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

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

        {% note info "Вы не сможете найти полученный токен в личном кабинете" %}

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

        {% endnote %}

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

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

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