维控 慧盒第三方数据接口文档指南.pdfVIP

V-BOX 第三方数据对接指南 目录 维控V-BOX第三方数据接口文档1 一、 基本信息 1 二、 基础接口 2 1. 登录接口2 三、业务数据接口 3 1. 盒子列表 （旧，单级分组） 3 2. 盒子列表 （新，多级分组） 6 3. 实时监控点分组列表 10 4. 实时监控点配置列表 11 5. 实时监控点数据列表 14 6. 修改实时监控点值 16 7. 历史监控点列表 17 8. 历史数据列表 19 8.报警数据列表 21 9.获取盒子状态 24 10.通知盒子上报实时数据 25 四、附录 26 1. 数据类型 26 维控 V-BOX 第三方数据接口文档 一、 基本信息  服务器地址 http///box-data/api/{acturl}  传输协议 使用 http协议  接口参数说明 全局参数(头部参数) 所有接口都必须传全局参数（全局参数拼成 JSON格式放到 Headers的common参数 ） 参数名 说明 登录会话 ID ，表示已经登录过了 ，首先调用登录接口获取 ，所以登录接口不 sid 传 ，其他接口都需要传 comid 公司 Id(需要申请) compvtkey 公司私有 key(需要申请) ts 时间戳 ，格式如 ：1595380821000 计算规则 ： 将所有参数 ，包括上面的头部参数和每个接口单独的业务参数以 key=value 的格式进行拼接 ，使用符号间隔 ，举个例子 ，如登录接口 ，拼接后的结果如 下 ： alias=testcomid=xxxxxcompvtkey=xxxxxpassword=dc6e6a331dc 2b23420d99c53a0d4962ets=1595381946008key=f1cd9351930d4e sign 589922edbcf3b09a7c 其中alias和 password是登录接口的业务参数 ，其他就是上面的头部参数（注 意 ：登录接口不用放 sid ，其他接口记得加上 sid ） 所有参数以首字母排序 ，首字母相同则按第二个字母 ，以此内推。最后的 key=f1cd9351930d4e589922edbcf3b09a7c是固定的 ，每个接口都需要传 ， 并且都放在最后面 最后将拼接好的结果计算出 MD5值就生成 sign了 最终头部的参数如下 （注意 ：登录接口不用放 sid ，其他接口记得加上 sid ，ts 的值和上面计 算 sign的ts值必须相同 ）： common{comid xxxxx,compvtkey xxxxx,sign fa4fb6bbcc2073db4dedca5a 3611b99d,ts1595380821000,sid xxxxx} 返回结果用 Json表示 ，区分大小写 ，如 ： 1.异常 {code 403, msg SessionID(用户的会话标识)无效, reqId 1502074141465} 2.正常 {code 200 , result {}, msg ok, reqId 1502074141465} 通用状态码描述 错误码 描述 200 成功