Протокол программного управления устройствами
С помощью данного API пользователь может самостоятельно автоматизировать управление устройствами, подключенными к платформе умного дома Яндекса.
Для пользовательских приложений поддерживается управление устройствами, группами и сценариями.
Хост для всех запросов к API: https://api.iot.yandex.net
Метод |
Ресурс |
OAuth scope |
Описание |
|
|
Получение полной информации об умном доме пользователя |
|
|
|
Получение информации о состоянии устройства |
|
|
|
Управление умениями устройств |
|
|
|
Получение информации о состоянии группы устройств |
|
|
|
Управление умениями группы устройств |
|
|
|
Управление запуском сценария |
|
|
|
Удаление пользовательского устройства |
Доступ и авторизация
Для использования API платформы необходимо зарегистрировать приложение на сервере авторизации Яндекс OAuth и запросить необходимые доступы для устройств умного дома (iot:view
, iot:control
).
Примечание
Если вы хотите получить OAuth-токен для тестирования, воспользуйтесь отладочным токеном.
После того, как пользователь дал приложению необходимые доступы, его токен можно использовать для запросов к API платформы умного дома. Токен необходимо указывать в каждом запросе к API в заголовке Authorization:
curl -i -X GET 'https://api.iot.yandex.net/v1.0/user/info' \
-H 'Authorization: Bearer YOUR_OAUTH_TOKEN'
Больше о том, как запрашивать разрешение пользователя на доступ к данным, читайте в документации по OAuth-авторизации.