Получаем API Key для Deconz, Hue и не только…

Чтобы подключить к Deconz сторонние приложения, необходимо получить ключ API key, который в дальнейшем будет использоваться для управления подключенными устройствами. Некоторые приложения, такие как Home Assistant, умеют самостоятельно добывать этот ключ, от пользователя требуется только нажать кнопку в интерфейсе для авторизации этого приложения, другим программам (в моем случае для интеграции с Node Red) требуется сообщить этот ключ в явном виде. Сегодня мы научимся добывать его самостоятельно, плюс еще несколько бонусов.

Инструкция актуальна так же и для системы Hue

В браузере Chrome открываем ссылку и устанавливаем расширение Tabbed Postman - REST Client
Значок Postman должен появиться в правой верхней части интерфейса Chrome, правее адресной строки. Нажимаем на значок и попадаем в интерфейс Postman.
Вбиваем ссылку: https://dresden-light.appspot.com/discover в строку запроса в Postman, тип запроса GET, нажимаем кнопку Send и видим ответ со всей информацией о шлюзе Deconz, если таковой имеется в локальной сети.

В строке запроса вбиваем полученные локальный IP адрес и порт в виде:  IP_шлюза:порт/api, меняем тип запроса на POST, формат запроса raw, в тело запроса вписываем { "devicetype": "my aaplication" } и снова нажимаем SEND

В ответе видим ошибку - кнопка соединения не нажата. Переходим в интерфейс Phoscon - gateway - advanced, и нажимаем autentificate app. Возвращаемся в интерфейс Postman и снова нажимаем Send. В ответе мы увидим необходимый нам api key:

Испробуем некоторые возможности применения: Получаем список ламп: отправляем GET запрос в формате IP_шлюза:порт/api/<apikey>/lights

Получаем информацию о лампе: отправляем GET запрос в формате IP_шлюза:порт/api/<apikey>/lights/<ID лампы>

Вкл/выкл лампу: отправляем PUT запрос в формате: IP_шлюза:порт/api/<apikey>/lights/<ID лампы>/state. В теле запроса пишем: { "on": true }

В результате нужная лампа должна включиться.

Полученные в данной статье информацию и знания мы используем в следующей части: Установим Node Red, свяжем его c Deconz и создадим первую автоматизацию.