使用指南

初始化配置

1. 获取 AppKey 和 AppSecret（请联系管理员）
2. 配置推送地址
3. 开启实时推送
4. 配置定时推送（可选，若不配置按默认推送频率进行推送。实时数据为 30 分钟，设备状态是 10 分钟）

数据查询

• 查询设备列表
• 查询实时数据
• 根据业务需要调用相应的接口

解释说明

认证签名

• 妥善保管 appSecret
• 每次请求使用新的 timestamp
• 签名算法：MD5(appKey + ":" + timestamp + ":" + appSecret)
• timestamp 有效期为 5 分钟

数据获取

• 数据变化都会向第三方主动推送（配置推送地址的前提下）
• 向平台查询数据时注意限流（目前限制频率是 100 次/分钟）

测试说明

本文档都是 HTTP 接口，推荐使用 PostMan 工具进行接口测试，方便测试接口连通性和接口的请求响应数据。

名词说明

名词	说明
区域	树形节点结构，例如"广东省-深圳市-南山区-机房"就是一个 4 层树形节点的区域。区域可以看做是一个设备分组
设备	属于一个区域节点，例如机房、基站下的设备。可以先获取区域节点，再通过区域节点去获取区域下面的设备，也可以一次性获取全部设备
属性量	实时数据里面的属性量，例如温湿度设备包含温度和湿度两个属性量
产品	设备的属性量汇总，例如温湿度设备除了温度和湿度，还有信号、电量等，这些属性量可以通过获取产品去获取