---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-protocol.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-protocol.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-protocol.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741

# Протокол программного управления устройствами

<!-- source: ru/_includes/reusables/neuroexpert-button.md -->



<!-- endsource: ru/_includes/reusables/neuroexpert-button.md -->


С помощью данного API пользователь может самостоятельно автоматизировать управление устройствами, подключенными к платформе умного дома Яндекса.

Для пользовательских приложений поддерживается управление устройствами, группами и сценариями.

Хост для всех запросов к API: `https://api.iot.yandex.net`

#|
||
**Метод**
|
**Ресурс**
|
**OAuth scope**
|
**Описание**
||

||
[GET](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-user-info.md)
|
`v1.0/user/info`
|
`iot:view`
|
Получение полной информации об умном доме пользователя
||

||
[GET](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-device-info.md)
|
`v1.0/devices/{device_id}`
|
`iot:view`
|
Получение информации о состоянии устройства
||

||
[POST](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-capabilities.md)
|
`v1.0/devices/actions`
|
`iot:control`
|
Управление умениями устройств
||

||
[GET](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-group-device-info.md)
|
`v1.0/groups/{group_id}`
|
`iot:view`
|
Получение информации о состоянии группы устройств
||

||
[POST](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-group-capabilities.md)
|
`v1.0/groups/{group_id}/actions`
|
`iot:control`
|
Управление умениями группы устройств
||

||
[POST](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-scenario.md)
|
`v1.0/scenarios/{scenario_id}/actions`
|
`iot:control`
|
Управление запуском сценария
||

||
[DELETE](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/platform-delete.md)
|
`v1.0/devices/{device_id}`
|
`iot:control`
|
Удаление пользовательского устройства
||
|#


### Доступ и авторизация {#platform-access}

Для использования API платформы необходимо зарегистрировать приложение на сервере авторизации [Яндекс OAuth](https://oauth.yandex.ru/client/new/) и запросить необходимые доступы для устройств умного дома (`iot:view`, `iot:control`).


{% note info %}

Если вы хотите получить OAuth-токен для тестирования, воспользуйтесь [отладочным токеном](https://yandex.ru/dev/id/doc/dg/oauth/tasks/get-oauth-token.html).

{% endnote %}


После того, как пользователь дал приложению необходимые доступы, его токен можно использовать для запросов к API платформы умного дома. Токен необходимо указывать в каждом запросе к API в заголовке Authorization:

```bash translate=no
curl -i -X GET 'https://api.iot.yandex.net/v1.0/user/info' \
-H 'Authorization: Bearer YOUR_OAUTH_TOKEN'
```

Больше о том, как запрашивать разрешение пользователя на доступ к данным, читайте в документации по [OAuth-авторизации](https://yandex.ru/dev/oauth/).

<!-- source: ru/_includes/about/id-support/support-button.md -->
[![Служба поддержки](../_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)
<!-- endsource: ru/_includes/about/id-support/support-button.md -->