Skip to content

Latest commit

 

History

History
29 lines (21 loc) · 1.39 KB

设备属性上报.md

File metadata and controls

29 lines (21 loc) · 1.39 KB

设备属性推送

智能设备需要实时上报属性,以便应用和用户可以实时了解到设备状态的改变。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 (服务器出错)