电供暖系统code含义表、接口详解.docxVIP

PAGE PAGE 12 PAGE PAGE 1 （资料性附录）code含义表 code含义见表A.1。 code含义表 序号 code值 含义 1 0000 无异常 2 0001 密钥超时 3 0002 参数缺失 4 0003 参数值格式有误 5 8008 未知异常 （资料性附录）接口详解 获取设备数据列表接口解析见表B.1。 表B.1 获取设备数据列表接口解析表 请求方式 GET 接口路径 /data/list Header参数 key:密钥 Body参数 deviceId:监控系统ID equipmentAdd:设备地址 返回值类型 application/json 返回值描述 { message:OK, state:1, code:0000, data: //数据列表 { voltage:电压, current:电流, power:功率, indoorTemp:室内温度, outsideTemp:室外温度, … } } 获取设备实时数据接口解析见表B.2。 表B.2 获取设备实时数据接口解析表 请求方式 GET 接口路径 /data：获取所有数据实时值，/data/name:根据数据项名称获取 Header参数 key:密钥 Body参数 deviceId:监控系统ID equipmentAdd:设备地址 dataName:数据项名称，根据数据项名称获取时需要 返回值类型 application/json 返回值描述 { message:OK, state:1, code:0000, data: //数据值 { voltage:220, current:2, power:440, … } } 获取设备历史数据接口解析见表B.3。 表B.3 获取设备历史数据接口解析表 请求方式 GET 接口路径 /data/record/name Header参数 key:密钥 Body参数 deviceId:监控系统ID equipmentAdd:设备地址 dataName:数据项名称 beginTime:开始时间 endTime:结束时间 返回值类型 application/json 返回值描述 { message:OK, state:1, code:0000, data: //数据值 [ { id:1, value:220,//值 time:1502089272000 //时间戳 }, { id:2, value:222, time:1502089272000 } ... ] } 远程控制接口解析见表B.4。 表B.4 远程控制接口解析表 请求方式 POST 接口路径 /control Header参数 key:密钥 Body参数 deviceId:监控系统ID equipmentAdd:设备地址 code:操作代码，0010-开关机，可扩展 value:1-开机，0-关机 返回值类型 application/json 返回值描述 { message:OK, state:1, code:0000, data: } 运行时间统计接口解析见表B.5。 表B.5 运行时间统计接口解析表 请求方式 GET 接口路径 /runtime Header参数 key:密钥 Body参数 deviceId:监控系统ID equipmentAdd:设备地址,可选，不选时统计监控系统下所有设备 beginTime:开始时间 endTime:结束时间 period:统计周期,0-日，1-月，2-年 返回值类型 application/json 返回值描述 { message:OK, state:1, code:0000, data: [ { id:1, value:22000,//运行时间 unit:s ,//单位 date:2017-10//日期 }, { id:2, value:22000, unit:s , date:2017-11 } ... ] } 报警时间统计接口解析见表B.6。 表B.6 报警时间统计接口解析表 请求方式 GET 接口路径 /alarmtime Header参数 key:密钥 Body参数 deviceId:监控系统ID equipmentAdd:设备地址,可选，不选时统计监控系统下所有设备 beginTime:开始时间 endTime:结束时间 period:统计周期,0-日，1