智能设备需要实时上报属性,以便应用和用户可以实时了解到设备状态的改变。AIOT建立了完善的设备管理和资源管理机制,可以实时掌握设备状态,并通过订阅接口,将这些信息实时推送至第三方应用后台。这就需要第三方应用后台提供订阅接口,这里需要规范一下接口的数据格式。此处建议提供HTTPS协议接口。
绿米智能硬件的属性均使用资源的方式来定义(详见资源定义文档),AIOT收到设备属性上报之后,立即将数据推送至第三方应用后台提供的接口。数据格式如下:
msgType | resource |
---|---|
描述 | 设备属性推送 |
header | {"Appid":"xxx","Appkey":"xxx"} |
payload | {"msgType":"resource","data":[{"did":"xxx","time":xxx,"attr":"xxx","value":"xxx"}]} |
- attr: 设备属性
- msgType: 消息类型
- time: 时间戳(单位为秒)
##消息回复格式
回复消息中需包含code字段,用于表示是否接收成功。
code | 错误码 |
---|---|
0 | SUCCESS (成功) |
100 | ERROR_TIMEOUT (超时) |
301 | ERROR_REQUEST_PATH (请求路径错误) |
302 | ERROR_REQUEST_PARAMS (请求参数错误) |
801 | ERROR_APPID_OR_APPKEY_ILLEGAL (appId或appKey有误) |
500 | ERROR_INTERNAL_SERVER (服务器出错) |