用于与hubitatapi交互的python库
pyhubitat的Python项目详细描述
皮胡比塔
用于与Hubitat API交互的python库
亮点
这个软件包是新的,发展迅速。它目前只公开了Hubitat的“makerapi”,它仅限于设备的功能,而不是集线器。官方的makerapi文档可以在here找到。 暴露的终结点包括:
- 获取所有设备(/Devices)
- 获取包含完整详细信息的所有设备(/Devices/All)
- 获取设备信息(/devices/[Device ID])
- 获取设备事件历史记录(/Device/[Device ID]/events)
- 获取设备命令(/Device/[Device ID]/Commands)
- 获取设备功能(/Device/[Device ID]/Capabilities)
- 发送设备命令(/Device/[Device ID]/[Command]/[Secondary Value])
安装
pip install pyhubitat
使用
初始化
from pyhubitat import MakerAPI
import pprint
HUB_TOKEN = os.environ['HUBITAT_TOKEN']
HUB_URL_EXAMPLE = 'https://192.168.1.39/apps/api/24' # Follow the generic format of 'https://[hub-ip-address-or-hostname]/apps/api/[app-id]'
ph = MakerAPI(HUB_TOKEN, HUB_URL_EXAMPLE)
获取设备
^{pr2}$发送命令
response1 = ph.send_command(5, "on")
response2 = ph.send_command(6, "setLevel", 50)
关于TLS/SSL的说明
hubitathub使用了一个自签名的https根证书,我认为没有合理的方法来添加自己的证书。尽管如此,仍然建议您在集线器上启用login auth并使用https API url,因为您的API令牌随每个请求一起发送。在
- 项目
标签: