附件1
设备在线安全监测预警系统功能要求及接口标准
序号 | 功能类别 | 性能参数说明 | 备注 |
1 | 整体要求 | 控制主机必须装备具有采集、记录、显示、传输、预警、报警功能,一体化集成和符合以下各项所有要求,并将所有数据实时上传到建机系统中。 | 根据标准化管理委员会,联合发布塔式起重机国家标准 |
2 | 盲区可视化 | 盲区可视化应安装于起重臂上运行的小车上,并可实时将视频上传到建机系统。视频数据应保存不少于15天。 | / |
3 | 开机人员实名校验 | 开机人员身份校验应具备远程身份下达、人脸识别、智能控制,并实时将验证数据上传到建机系统。 | / |
4 | 运行状态监测 | 运行状态监测应具备故障诊断和超载、力矩、高度、幅度、防倾覆等运行监测。 | / |
5 | 施工升降机监测 | 具备防冲顶、开关门、开机人员校验、超载、人数识别等安全装置监测预警和远程故障诊断功能。 | 适用于施工升降机 |
6 | 钢丝绳在线监测 | 利用全磁能独立输出检测结果,分级判断损伤状态。符合《ISO 4309-2010起重机 钢丝绳保养、维护、检查和报废》等标准规范要求,并经计量检测和获得省部级以上应用案例。 | / |
7 | 产品质量与服务 | 1、需提供特种设备检测检验机构出具的检测检验合格报告与合格证;2、获得ISO质量体系认证和服务认证。3、至少一项技术获得省部级科学技术成果。 | 无 |
8 | 辅助功能 | 其他相关辅助系统功能。例如:设备机况自检等。 | 可选 |
为了满足和建机系统数据的无缝对接共享,特制定本数据接口标准。
需要将作业安全网络终端和设备在线安全监测预警系统数据实时上传到建机系统的企业或相关单位可通过本接口标准。
REST
(英文:Representational State Transfer,简称REST)描述了一个架构样式的网络系统,比如 web 应用程序。
终端
是指上传作业记录、安全监测数据、视频和监控数据的作业终端、安全监测主机、视频摄像机等,统称为终端。
建机系统
是指海南省建筑起重机械安全管理信息系统,简称为建机系统。
终端调用接口采用HTTP请求的方式(GET/POST)。请求的参数必须带有唯一标识appId、密钥secret加密后的token、时间戳timestamp。
URL示例:
http://xxxxxx:8080/webservice/demo/upload?ak=APP00001&ts=1403593817968&token=wSzH0G5jKAxYILGo+5BOEd5g05g=
UrlEncode后的结果是:
http://127.0.0.1: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_6028e5d346d1b1690146d1b5c8f90001",
"corpCode" : "企业机构代码",
"corpName" : "企业名称",
"personName" : "人员名称",
......
......
"status":"新增",
"dataVersion" : 1,
"photo":"http://127.0.2.1:9093/attach/ATTACH_6/2016/10/27/x.jpg"
}
}
{
"result":false,
"error":"错误描述",
"error_code":"00000"
}
异常类型 | 异常编码 | 异常描述 |
请求错误 | 00000 | 请求错误 |
00001 | 请求参数错误 | |
00002 | 请求格式错误 | |
00003 | 请求超时 | |
00004 | 请求的appId在系统中找不到 | |
00005 | 授权错误 | |
00006 | 没有访问权限 | |
00007 | 文件上传的请求方式必须为post,MIME类型必须为multipart/form-data | |
系统错误 | 10001 | 系统错误 |
10002 | 上传文件发生错误 |
接口名称 | 业务数据更新接口 |
接口描述 | 将业务数据更新到建机系统 |
接口协议 | REST |
接口URL | http://www.jjaq.com.cn/webservice/video/videoInstall/update |
请求类型 | POST |
备注 | 1、必须带dcPK,源数据主键 |
名称 | 说明 | 数据类型 |
dcPK | 业务数据表主键 | String |
sourceId | 来源数据主键(终端) | String |
名称 | 说明 | 数据类型 |
dcPK | 业务数据主键 | String |
sourceId | 来源数据主键(终端) | String |
updateTime | 数据更新时间 | String |
status | 数据状态 | String |
dataVersion | 数据版本 | Double |
接口名称 | 业务数据查询接口 |
接口描述 | 根据查询条件查询SDIC系统的业务数据。 |
接口协议 | REST |
接口方法 | http://www.jjaq.com.cn/webservice/video/videoInstall/search |
请求类型 | GET |
备注 | 查询中string支持模糊查询,只需要在在参数值前后加%,如:corpName中间包含(corpName=%value%),左包含(corpName=value%),右包含(corpName=%value);int,double,long,date的支持区间查询,直选在参数值中间加“,”(英文逗号),如:updateTime查询,between2014-10-10and2014-12-12为(updateTime=2014-10-10,2014-12-12),2014-10-10之后的为(updateTime=2014-10-10,),2014-10-10之前为(updateTime=,2014-10-10)。分页参数为:page(页码),pageSize(一页记录数) |
名称 | 说明 | 数据类型 |
按照规范,原则上所有字段均可作为查询条件。一般根据需要设置即可 |
名称 | 说明 | 数据类型 |
dcPK | 数据主键 | String |
sourceId | 终端数据主键 | String |
updateTime | 数据更新时间 | String |
status | 数据状态(1:新增,2:更新,4:删除) | String |
dataVersion | 数据版本 | Double |
6.2. 维护信息接口
接口名称 | 业务数据更新接口 |
接口描述 | 将业务数据更新到建机系统 |
接口协议 | REST |
接口URL | http://www.jjaq.com.cn/webservice/video/videoMaintain/update |
请求类型 | POST |
备注 | 1、必须带dcPK,源数据主键 |
名称 | 说明 | 数据类型 |
dcPK | 业务数据表主键 | String |
sourceId | 来源数据主键(终端) | String |
名称 | 说明 | 数据类型 |
dcPK | 业务数据主键 | String |
sourceId | 来源数据主键(终端) | String |
updateTime | 数据更新时间 | String |
status | 数据状态 | String |
dataVersion | 数据版本 | Double |
接口名称 | 业务数据查询接口 |
接口描述 | 根据查询条件查询SDIC系统的业务数据。 |
接口协议 | REST |
接口方法 | http://www.jjaq.com.cn/webservice/video/videoMaintain/search |
请求类型 | GET |
备注 | 查询中string支持模糊查询,只需要在在参数值前后加%,如:corpName中间包含(corpName=%value%),左包含(corpName=value%),右包含(corpName=%value);int,double,long,date的支持区间查询,直选在参数值中间加“,”(英文逗号),如:updateTime查询,between2014-10-10and2014-12-12为(updateTime=2014-10-10,2014-12-12),2014-10-10之后的为(updateTime=2014-10-10,),2014-10-10之前为(updateTime=,2014-10-10)。分页参数为:page(页码),pageSize(一页记录数) |
名称 | 说明 | 数据类型 |
按照规范,原则上所有字段均可作为查询条件。一般根据需要设置即可 |
名称 | 说明 | 数据类型 |
dcPK | 数据主键 | String |
sourceId | 终端数据主键 | String |
updateTime | 数据更新时间 | String |
status | 数据状态(1:新增,2:更新,4:删除) | String |
dataVersion | 数据版本 | Double |
接口名称 | 业务数据更新接口 |
接口描述 | 将业务数据更新到系统 |
接口协议 | REST |
接口URL | http://www.jjaq.com.cn/webservice/video/videoPause/update |
请求类型 | POST |
备注 | 1、必须带dcPK,源数据主键 |
名称 | 说明 | 数据类型 |
dcPK | 业务数据表主键 | String |
sourceId | 来源数据主键(终端) | String |
名称 | 说明 | 数据类型 |
dcPK | 业务数据主键 | String |
sourceId | 来源数据主键(终端) | String |
updateTime | 数据更新时间 | String |
status | 数据状态 | String |
dataVersion | 数据版本 | Double |
接口名称 | 业务数据查询接口 |
接口描述 | 根据查询条件查询SDIC系统的业务数据。 |
接口协议 | REST |
接口方法 | http://www.jjaq.com.cn/webservice/video/videoPause/search |
请求类型 | GET |
备注 | 查询中string支持模糊查询,只需要在在参数值前后加%,如:corpName中间包含(corpName=%value%),左包含(corpName=value%),右包含(corpName=%value);int,double,long,date的支持区间查询,直选在参数值中间加“,”(英文逗号),如:updateTime查询,between2014-10-10and2014-12-12为(updateTime=2014-10-10,2014-12-12),2014-10-10之后的为(updateTime=2014-10-10,),2014-10-10之前为(updateTime=,2014-10-10)。分页参数为:page(页码),pageSize(一页记录数) |
名称 | 说明 | 数据类型 |
按照规范,原则上所有字段均可作为查询条件。一般根据需要设置即可 |
名称 | 说明 | 数据类型 |
dcPK | 数据主键 | String |
sourceId | 终端数据主键 | String |
updateTime | 数据更新时间 | String |
status | 数据状态(1:新增,2:更新,4:删除) | String |
dataVersion | 数据版本 | Double |
部分内容由用户投稿或者来源于网络,如有侵权,请联系底部邮箱进行删除!非常感谢您的支持!