DOC《远程监控系统接口标准》

远程监控系统接口标准 1.

编制说明

3 2. 目的

3 3. 名词术语

3 4. 接口授权

4 5. 调用接口方式

4 6. 参数定义

4 6.1. 验证参数

4 6.2. 请求值

5 6.3. 返回值

5 6.3.1. 返回类型

5 6.3.2. 异常编码error_code定义

6 7. 数据标准

6 7.1. 项目申报基本交互单元信息

6 7.2. 工程项目基本信息

7 7.3. 单位工程基本信息

8 7.4. 远程监控安装信息

9 7.5. 远程监控设备安装接入数据信息

9 7.6. 远程监控设备与单位工程绑定信息

10 7.7. 远程监控维护信息

11 7.8. 远程监控暂停信息

12 7.9. 远程监控恢复信息

13 7.10. 远程监控拆除信息

14 7.11. 全景成像测量摄像机业务数据信息

14 7.12. 通用摄像机业务数据信息

15 7.13. 视频在线率统计汇总数据信息

16 8. 接口定义

17 8.1. 项目申报基本交互单元信息接口

17 8.1.1. 数据查询接口

17 8.2. 工程项目基本信息接口

18 8.2.1. 数据查询接口

18 8.3. 单位工程基本信息接口

19 8.3.1. 数据查询接口

19 8.4. 远程监控安装信息接口

21 8.4.1. 数据更新接口

21 8.4.2. 数据查询接口

22 8.5. 远程监控安装设备与单位工程信息接口

23 8.5.1. 数据新增接口

23 8.5.2. 数据更新接口

24 8.5.3. 数据删除接口

25 8.5.4. 数据获取接口

26 8.5.5. 数据查询接口

27 8.6. 远程监控维护信息接口

28 8.6.1. 数据更新接口

28 8.6.2. 数据查询接口

29 8.7. 远程监控暂停信息接口

30 8.7.1. 数据更新接口

30 8.7.2. 数据查询接口

31 8.8. 远程监控恢复信息接口

32 8.8.1. 数据更新接口

32 8.8.2. 数据查询接口

33 8.9. 远程监控拆除信息接口

35 8.9.1. 数据更新接口

35 8.9.2. 数据查询接口

36 8.10. 远程监控设备安装统一接入信息接口

37 8.10.1. 全景成像测量摄像机设备接入请求

37 8.10.2. 加工场摄像机、大门出入口摄像机、塔式起重机超视野摄像机等通用摄像机设备接入请求

38 8.10.3. 环境侦测预警联动设备接入请求

39 8.10.4. 吊装设备操作员智能识别设备接入请求

40 8.11. 远程监控设备远程监控维护信息接口

41 8.11.1. 远程监控设备报修请求

41 8.11.2. 远程监控设备移机请求

42 8.12. 全景成像测量摄像机业务信息接口

42 8.12.1. 获取全景图列表接口

42 8.12.2. 获取节点图接口

43 8.12.3. 获取测量图接口

44 8.12.4. 上传全景图接口

44 8.12.5. 上传节点图接口

45 8.12.6. 上传测量图接口

45 8.13. 通用摄像机业务接口标准(应用于加工场摄像机、大门出入口摄像机、塔式起重机超视野摄像机)

46 8.13.1. 按工程项目获取通用摄像机设备列表

46 8.13.2. 通用摄像机历史视频地址请求

47 8.13.3. 通用摄像机历史视频播放请求

48 8.13.4. 通用摄像机视频截图上传请求

48 8.14. 吊装设备操作员智能识别业务接口标准

49 8.14.1. 获取智能识别设备操作人员信息

49 8.14.2. 智能识别设备认证请求

50 8.14.3. 获取操作员账号状态请求

51 8.14.4. 根据管理员ID获取认证错误列表请求

52 8.14.5. 管理员审核

53 8.14.6. 获取人员的智能识别设备操作记录

54 8.15. 环境侦测预警联动系统接口标准

54 8.15.1. 环境侦测预警联动设备信息获取

54 8.15.2. 环境侦测预警联动设备实时数据上传请求

55 8.15.3. 环境侦测预警联动设备实时数据获取

56 8.15.4. 环境侦测预警联动设备历史数据获取

57 8.15.5. 环境侦测预警联动设备喷淋联动阈值设置

58 8.16. 钢筋质量见证取样系统接口标准

59 8.16.1. 创建见证取样任务接口

59 8.16.2. 远程视频监控测量仪抓拍图片上传接口

60 8.16.3. 手机抓拍图片上传接口

61 8.16.4. 检测机构检测员获取样品任务请求

62 8.16.5. 检测机构检测员手机拍照上传接口

62 8.16.6. 见证取样原图与送检试样图片比对认证请求

63 8.17. 视频在线率统计汇总信息接口

64 8.17.1. 福建省工程视频在线率统计汇总请求

64 8.17.2. 福建省 闽江杯 优质工程视频在线率统计汇总请求

65 9. 申报交互简述

66 编制说明 目的 为了指导源系统与福建省互联互通中心之间的数据交互,特制定本规范.本规范为福建省数据对象公司,规定了源系统与福建省互联互通系统之间的应用层接口协议. 名词术语 REST (英文:Representational State Transfer,简称REST)描述了一个架构样式的网络系统,比如 web?应用程序. 源系统 上传数据的应用系统. 接口授权 源系统访问互联互通中心的服务接口,必须由互联互通中心授权颁发.互联互通中心将颁发给源系统全网唯一的appId和密钥secret,并为每个appId授权交互接口.如果源系统访问的接口没有得到授权,互联互通中心将拒绝访问.互联互通中心统一管理源系统接口的授权和取消. 调用接口方式 源系统调用接口采用HTTP请求的方式(GET/POST).请求的参数必须带有唯一标识appId、密钥secret加密后的token、时间戳timestamp. URL示例: http://localhost:8080/webservice/demo/upload?ak=APP00001&

ts=1403593817968&

token=wSzH0G5jKAxYILGo+5BOEd5g05g= UrlEncode后的结果是: http://localhost:8080/webservice/demo/upload?ak=APP00001&

ts=1403593817968&

token=wSzH0G5jKAxYILGo%2B5BOEd5g05g%3D 参数定义 验证参数 接口调用时必须上传的权限验证参数,所以在接口定义的请求参数不再说明. 名称 说明 数据类型 appId 互联互通中心颁发给源系统的唯一标识 String token 认证码=BASE64(SHA1(SHA1(appId+ timestamp+ secret)))secret为SDIC颁发给BAS的密钥 String timestamp 当前时间戳 String 请求值 在业务数据新增、更新业务数据的时候,将请求参数格式话为json对象,json对象作为字符串提交. 业务数据json标准: { sourceId : xxxxxx corpCode : xxxxxx corpName : xxxxxx , personName : xxxxxx , idCard : xxxxxx , ...... } 返回值 返回类型 接口调用的返回均采用json对象返回. 记录返回数据标准 { result : true, data : { dcPK : DC_4028e5d346d1b1690146d1b5c8f80001 , corpCode : 企业机构代码 , corpName : 企业名称 , personName : 人员名称 , ...... ...... status : 新增 , dataVersion : 1, photo : http://192.168.102.5:8093/attach/ATTACH_3/2014/11/27/x.jpg } } 异常返回数据标准 { result :false, error : 错误描述 , error_code :

00000 } 异常编码error_code定义 异常类型 异常编码 异常描述 请求错误

00000 请求错误

00001 请求参数错误

00002 请求格式错误

00003 请求超时

00004 请求的appId在系统中找不到

00005 授权错误

00006 没有访问权限

00007 文件上传的请求方式必须为post,MIME类型必须为multipart/form-data 系统错误

10001 系统错误

10002 上传文件发生错误 数据标准 项目申报基本交互单元信息 该信息由建设单位在 动态系统 进行申报,并上传到互联互通中心,远程监控系统在从互联互通中心通过8.1的查询接口进行下载获取.该交互单元在草稿状态就已经上传,所以项目省代码是为空的(只有在项目审核通过的时候才会生成并上传到互联互通中心).目前该基本交互单元已经将 动态系统 从2011年至今的符合条件的项目数据(草稿、退回、提交(审核中)、待确认、已确认、竣工提交(审核中)、审核通过(在建)、暂停、完工、竣工)都补充上传到互联互通中心. 字段名称 字段代码 字段 类型 字段 长度 小数 位数 约束 条件 备注 项目名称 prjName varchar

2000 M 项目省代码 provincePrjNum varchar

30 M 项目主键 proId varchar

64 M 建设单位机构代码 corpCode varchar

25 M 建设单位机构名称 corpName varchar

200 M 项目创建日期 createDate Date

0 工程项目基本信息 该工程信息库在互联互通中心只包含工程项目状态为:审核通过在建、暂停、完工、竣工的项目信息.如果想获取除7.1信息外的其他字段信息可以通过查询8.2的接口获取7.2的工程项目基本信息(比如质量监督站名称,安全监督站名称等等). 字段名称 字段代码 字段 类型 字段 长度 小数 位数 约束 条件 备注 项目编号 prjNum varchar

20 M 详见编码规则 项目编号(省编号) provincePrjNum varchar

20 M 工程所属地 prjBelongAddr varchar

100 工程所在地 prjLocalAddr varchar

100 项目名称 prjName varchar

200 M 建设单位名称 buildCorpName varchar

200 M 建设单位组织机构代码 buildCorpCode varchar

15 M 建设单位负责人 buildPersonName varchar

20 M 建设单位负责人电话 buildPersonPhone varchar

20 O 项目所在省 provinceNum int M 详见数据字典表TBXZQDMDIC 项目所在地市 cityNum int M 详见数据字典表TBXZQDMDIC 项目所在区县 countyNum int M 详见数据字典表TBXZQDMDIC 当前工程状态 prjStatus varchar

6 M 记录登记时间 createDate date M 单位工程基本信息 字段名称 字段代码 字段 类型 字段 长度 小数 位数 约束 条件 备注 项目编号 prjNum varchar

20 M 详见编码规则 项目编号(省编号) provincePrjNum varchar

20 M 项目Id proId varchar

64 M 单位工程Id itemId Varchar

64 M 单位工程名称 singleProName varchar

1000 M 单位工程类别 singleProType varchar

50 建筑高度 archHeight decimal

15 4 建筑面积 archArea decimal

15 4 市政长度 muniLength decimal

15 4 状态 itemStatus varchar

6 ±0.000以上层数 structUpfloorNum decimal

15 4 ±0.000以下层数 structDwfloorNum decimal

15 4 远程监控安装信息 该信息由施工单位在 动态系统 进行申报,并上传到互联互通中心,远程监控系统在从互联互通中心通过8.3的查询接口进行下载获取.当服务运营商安装结束后,远程监控系统调用互联互通中心8.3的更新接口,把完成时间、备注等相关数据返回到互联互通中心. 字段名称 字段代码 字段 类型 字段 长度 小数 位数 约束条件 备注 申报Id dcPk varchar

64 M 项目名称 prjName varchar

2000 M 动态系统登记 项目省代码 provincePrjNum varchar

30 M 动态系统登记 监管系统项目主键 proId varchar

64 M 动态系统登记 远程监控系统项目主键 detectProId varchar

64 动态系统登记 服务运营商 serviceOperator varchar

20 M 动态系统登记 电信、移动、联通 申报时间 declareDate datetime M 动态系统登记 申报备注 declareRemark varchar

2000 M 动态系统登记 申报施工单位组织机构代码 corpCode varchar

15 M 动态系统登记 申报施工单位名称 corpName varchar

200 M 动态系统登记 计划安装完成时间 planInstallDate datetime 动态系统产生 申报时间+30天 实际安装完成时间 actualInstallDate datetime 远程监控系统返回 安装备注 installRemark varchar

2000 远程监控系统返回 … 远程监控设备安装接入数据信息 该信息由远程监控系统登记,远程监管系统调用8.10下的4个接口时,会自动生成这张表数据. 字段名称 字段代码 字段 类型 字段 长度 小数 位数 约束 条件 备注 项目省代码 provincePrjNum varchar

30 M 项目主键 proId varchar

64 M 远程监控系统项目主键 detectProId varchar

64 施工单位组织机构代码 corpCode varchar

15 M 施工单位名称 corpName varchar

200 M 设备编号 devId varchar

64 M 设备名称 devName varchar

128 M 设备安装位置 devInstalPlace varchar

128 设备运行参数配置 devPlayConfig varchar

100 设备型号 devUnitType varchar

64 设备类型 devType varchar

16 M 1:全景成像测距摄像机 2:加工场摄像机 3:大门出入口摄像机 4:吊装设备操作员智能识别设备 5:塔式起重机超视野摄像机 6:环境侦测预警联动设备 流程状态 devFlowState varchar

16 开通时间 devDateStartUse datetime 拆机时间 devDateUninstall datetime 远程监控设备与单位工程绑定信息 该信息由远程监控系统登记,远程监管系统调用8.5下的接口来生成. 字段名称 字段代码 字段 类型 字段 长度 小数 位数 约束 条件 备注 项目省代码 provincePrjNum varchar

30 项目Id proId varchar

64 M 远程监控系统项目主键 detectProId varchar

64 设备编号 devId varchar

64 M 单位工程Id itemId varchar

64 M 远程监控维护信息 该信息由施工单位在 动态系统 进行申报,并上传到互联互通中心,远程监控系统在从互联互通中心通过8.6的查询接口进行下载获取.当服务运营商维护结束后,远程监控系统调用互联互通中心8.6的更新接口,把故障原因、实际维护完成时间、备注等相关数据返回到互联互通中心. 字段名称 字段代码 字段 类型 字段 长度 小数 位数 约束条件 备注 项目名称 prjName varchar

2000 M 动态系统登记 项目省代码 provincePrjNum varchar

30 M 动态系统登记 监管系统项目主键 proId varchar

64 M 动态系统登记 远程监控系统项目主键 detectProId varchar

64 动态系统登记 服务运营商 serviceOp................