1、 远程监控系统接口标准软件详细设计第 1 页 共 68 页1. 编制说明 .32. 目的 .33. 名词术语 .34. 接口授权 .45. 调用接口方式 .46. 参数定义 .46.1. 验证参数 .46.2. 请求值 .56.3. 返回值 .56.3.1. 返回类型 .56.3.2. 异常编码 error_code 定义 .67. 数据标准 .67.1. 项目申报基本交互单元信息 .67.2. 工程项目基本信息 .77.3. 单位工程基本信息 .87.4. 远程监控安装信息 .97.5. 远程监控设备安装接入数据信息 .97.6. 远程监控设备与单位工程绑定信息 .107.7. 远程监控维护
2、信息 .117.8. 远程监控暂停信息 .127.9. 远程监控恢复信息 .137.10. 远程监控拆除信息 .147.11. 全景成像测量摄像机业务数据信息 .147.12. 通用摄像机业务数据信息 .157.13. 视频在线率统计汇总数据信息 .168. 接口定义 .178.1. 项目申报基本交互单元信息接口 .178.1.1. 数据查询接口 .178.2. 工程项目基本信息接口 .188.2.1. 数据查询接口 .188.3. 单位工程基本信息接口 .198.3.1. 数据查询接口 .198.4. 远程监控安装信息接口 .218.4.1. 数据更新接口 .218.4.2. 数据查询接口
3、.228.5. 远程监控安装设备与单位工程信息接口 .238.5.1. 数据新增接口 .238.5.2. 数据更新接口 .248.5.3. 数据删除接口 .258.5.4. 数据获取接口 .26软件详细设计第 2 页 共 68 页8.5.5. 数据查询接口 .278.6. 远程监控维护信息接口 .288.6.1. 数据更新接口 .288.6.2. 数据查询接口 .298.7. 远程监控暂停信息接口 .308.7.1. 数据更新接口 .308.7.2. 数据查询接口 .318.8. 远程监控恢复信息接口 .328.8.1. 数据更新接口 .328.8.2. 数据查询接口 .338.9. 远程监控
4、拆除信息接口 .358.9.1. 数据更新接口 .358.9.2. 数据查询接口 .368.10. 远程监控设备安装统一接入信息接口 .378.10.1. 全景成像测量摄像机设备接入请求 .378.10.2. 加工场摄像机、大门出入口摄像机、塔式起重机超视野摄像机等通用摄像机设备接入请求 .388.10.3. 环境侦测预警联动设备接入请求 .398.10.4. 吊装设备操作员智能识别设备接入请求 .408.11. 远程监控设备远程监控维护信息接口 .418.11.1. 远程监控设备报修请求 .418.11.2. 远程监控设备移机请求 .428.12. 全景成像测量摄像机业务信息接口 .428.
5、12.1. 获取全景图列表接口 .428.12.2. 获取节点图接口 .438.12.3. 获取测量图接口 .448.12.4. 上传全景图接口 .448.12.5. 上传节点图接口 .458.12.6. 上传测量图接口 .458.13. 通用摄像机业务接口标准（应用于加工场摄像机、大门出入口摄像机、塔式起重机超视野摄像机） .468.13.1. 按工程项目获取通用摄像机设备列表 .468.13.2. 通用摄像机历史视频地址请求 .478.13.3. 通用摄像机历史视频播放请求 .488.13.4. 通用摄像机视频截图上传请求 .488.14. 吊装设备操作员智能识别业务接口标准 .498.1
6、4.1. 获取智能识别设备操作人员信息 .498.14.2. 智能识别设备认证请求 .508.14.3. 获取操作员账号状态请求 .518.14.4. 根据管理员 ID 获取认证错误列表请求 .528.14.5. 管理员审核 .538.14.6. 获取人员的智能识别设备操作记录 .54软件详细设计第 3 页 共 68 页8.15. 环境侦测预警联动系统接口标准 .548.15.1. 环境侦测预警联动设备信息获取 .548.15.2. 环境侦测预警联动设备实时数据上传请求 .558.15.3. 环境侦测预警联动设备实时数据获取 .568.15.4. 环境侦测预警联动设备历史数据获取 .578.1
7、5.5. 环境侦测预警联动设备喷淋联动阈值设置 .588.16. 钢筋质量见证取样系统接口标准 .598.16.1. 创建见证取样任务接口 .598.16.2. 远程视频监控测量仪抓拍图片上传接口 .608.16.3. 手机抓拍图片上传接口 .618.16.4. 检测机构检测员获取样品任务请求 .628.16.5. 检测机构检测员手机拍照上传接口 .628.16.6. 见证取样原图与送检试样图片比对认证请求 .638.17. 视频在线率统计汇总信息接口 .648.17.1. 福建省工程视频在线率统计汇总请求 .648.17.2. 福建省“闽江杯”优质工程视频在线率统计汇总请求 .659. 申报
8、交互简述 .661. 编制说明2. 目的为了指导源系统与福建省互联互通中心之间的数据交互，特制定本规范。本规范为福建省数据对象公司，规定了源系统与福建省互联互通系统之间的应用层接口协议。3. 名词术语REST（英文：Representational State Transfer，简称 REST）描述了一个架构样式的网络系统，比如 web 应用程序。源系统上传数据的应用系统。软件详细设计第 4 页 共 68 页4. 接口授权源系统访问互联互通中心的服务接口，必须由互联互通中心授权颁发。互联互通中心将颁发给源系统全网唯一的 appId 和密钥 secret，并为每个 appId 授权交互接口。如果
9、源系统访问的接口没有得到授权，互联互通中心将拒绝访问。互联互通中心统一管理源系统接口的授权和取消。5. 调用接口方式源系统调用接口采用 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/webse
10、rvice/demo/upload?ak=APP00001&ts=1403593817968&token=wSzH0G5jKAxYILGo%2B5BOEd5g05g%3D6. 参数定义验证参数接口调用时必须上传的权限验证参数，所以在接口定义的请求参数不再说明。名称 说明 数据类型appId 互联互通中心颁发给源系统的唯一标识 Stringtoken 认证码=BASE64(SHA1(SHA1(appId+ timestamp+ secret)secret 为 SDIC 颁发给 BAS 的密钥Stringtimestamp 当前时间戳 String软件详细设计第 5 页 共 68 页6.2. 请求
11、值在业务数据新增、更新业务数据的时候，将请求参数格式话为 json 对象，json 对象作为字符串提交。业务数据 json 标准：“sourceId“:“xxxxxx“corpCode“:“xxxxxx“corpName“ : “xxxxxx“,“personName“ : “xxxxxx“,“idCard“ : “xxxxxx“,.6.3. 返回值6.3.1. 返回类型接口调用的返回均采用 json 对象返回。6.3.1.1. 记录返回数据标准 “result“ : true,“data“ : “dcPK“ : “DC_4028e5d346d1b1690146d1b5c8f80001“,“c
12、orpCode“ : “企业机构代码“,“corpName“ : “企业名称“,“personName“ : “人员名称“,.“status“:“新增“,“dataVersion“ : 1,“photo“:“http:/192.168.102.5:8093/attach/ATTACH_3/2014/11/27/x.jpg“软件详细设计第 6 页 共 68 页6.3.1.2. 异常返回数据标准“result“:false,“error“:“错误描述“,“error_code“:“00000“6.3.2. 异常编码 error_code 定义异常类型 异常编码 异常描述00000 请求错误0000
13、1 请求参数错误00002 请求格式错误00003 请求超时00004 请求的 appId 在系统中找不到00005 授权错误00006 没有访问权限请求错误00007 文件上传的请求方式必须为 post，MIME 类型必须为 multipart/form-data10001 系统错误系统错误10002 上传文件发生错误7. 数据标准7.1. 项目申报基本交互单元信息该信息由建设单位在“动态系统”进行申报，并上传到互联互通中心，远程监控系统在从互联互通中心通过 8.1 的查询接口进行下载获取。该交互单元在草稿状态就已经上传，所以项目省代码是为空的（只有在项目审核通过的时候才会生成并上传到互联互
14、通中心）。目前该基本交互单元已经将“动态系统” 从 2011 年至今的符合条件的项目数据（草稿、退回、提交（审核中）、待软件详细设计第 7 页 共 68 页确认、已确认、竣工提交（审核中）、审核通过（在建）、暂停、完工、竣工）都补充上传到互联互通中心。字段名称 字段代码 字段类型字段长度小数位数约束条件备注项目名称 prjName varchar 2000 M项目省代码 provincePrjNum varchar 30 M项目主键 proId varchar 64 M建设单位机构代码 corpCode varchar 25 M建设单位机构名称 corpName varchar 200 M项目
15、创建日期 createDate Date 07.2. 工程项目基本信息该工程信息库在互联互通中心只包含工程项目状态为：审核通过在建、暂停、完工、竣工的项目信息。如果想获取除 7.1 信息外的其他字段信息可以通过查询 8.2 的接口获取 7.2 的工程项目基本信息（比如质量监督站名称，安全监督站名称等等）。字段名称 字段代码字段类型字段长度小数位数约束条件备注项目编号 prjNum varchar 20 M 详见编码规则项目编号（省编号） provincePrjNum varchar 20 M工程所属地 prjBelongAddr varchar100工程所在地 prjLocalAddr var
16、char100项目名称 prjName varchar 200 M建设单位名称 buildCorpName varchar 200 M建设单位组织机构代码 buildCorpCode varchar 15 M建设单位负责人 buildPersonName varchar 20 M建设单位负责人电话 buildPersonPhone varchar 20 O项目所在省 provinceNum int M 详见数据字典表 TBXZQDMDIC软件详细设计第 8 页 共 68 页字段名称 字段代码字段类型字段长度小数位数约束条件备注项目所在地市 cityNum int M 详见数据字典表 TBXZQ
17、DMDIC项目所在区县 countyNum int M 详见数据字典表 TBXZQDMDIC当前工程状态 prjStatus varchar6 M记录登记时间 createDate date M7.3. 单位工程基本信息字段名称 字段代码字段类型字段长度小数位数约束条件备注项目编号 prjNum varchar 20 M 详见编码规则项目编号（省编号） provincePrjNum varchar 20 M项目 Id proId varchar64 M单位工程 Id itemId Varchar64 M单位工程名称 singleProName varchar 1000 M单位工程类别 sing
18、leProType varchar 50建筑高度 archHeight decimal 15 4建筑面积 archArea decimal 15 4市政长度 muniLength decimal 15 4状态 itemStatus varchar 60.000 以上层数 structUpfloorNum decimal 15 40.000 以下层数 structDwfloorNum decimal 15 4Comment h1: 新增软件详细设计第 9 页 共 68 页7.4.远程监控安装信息该信息由施工单位在“动态系统”进行申报，并上传到互联互通中心，远程监控系统在从互联互通中心通过 8.3
19、的查询接口进行下载获取。当服务运营商安装结束后，远程监控系统调用互联互通中心 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、 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 远程监控系统返回7.5.远程监控设备安装接入数据信息该信息由远程监控系统登记，远程监管系统调用 8.10下的 4个接口时，会自动生成这张表数据。字段名称 字段代码 字段类型 字段长度小数位数约束条件备注
