DB34T 4141-2022 电梯应急救援平台数据接口规范.pdf

ICS 35.100 CCS L 79 34 安徽省地方标准 DB 34/T 41412022 电梯应急救援平台数据接口规范 Data interface specification for elevator emergency rescue platform 2022-03-29 发布 2022-04-29 实施 安徽省市场监督管理局 发 布 DB 34/T 41412022 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省特种设备检测院提出。本文件由安徽省市场监督管理局归口。本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。本文件主要起草人：莫诚生、赵龙、许迪、许佳伟、严伟、姚刚、王启龙、熊钰才、汪源、许路夷。I DB 34/T 41412022 电梯应急救援平台数据接口规范 1 范围 本文件规定了电梯应急救援平台的数据交换架构、接口基本规定、接口协议清单及内容。本文件适用于省电梯应急救援管理平台（以下简称“省电梯平台”）与各地市或区县电梯应急救援管理平台（以下简称“地方电梯平台”）之间的数据交换。2 规范性引用文件 本文件没有规范性引用文件。3 术语和定义 下列术语和定义适用于本文件。3.1 使用单位 elevator user 新安装未移交业主的电梯，项目建设单位是使用单位；委托物业服务单位管理的电梯，物业单位是使用单位；产权单位自行管理的电梯，产权单位是使用单位。来源：TSG 08-2017，2.1.2 3.2 网格 grid 电梯应急救援的管理模式，一般救援响应分为三级：第一级响应由电梯签约维保单位实施；第二级由电梯应急救援机构实施；第三级由119、110等公共救援机构或外部救援专家实施。3.3 电梯唯一标识 the unique identification of elevator 用于电梯应急救援定位的唯一编码。3.4 JSON JavaScript对象简谱（(JavaScript Object Notation），是一种轻量级的数据交换格式。3.5 JavaScript 一种具有函数优先的轻量级、解释型或即时编译型的网页编程语言。3.6 HTTP 超文本传输协议（Hyper Text Transfer Protocol），是一种请求-响应协议。4 数据交换架构 1 DB 34/T 41412022 省电梯平台负责统一开发数据接口并进行维护更新，各地方电梯平台按照数据接口规范要求实现数据下载和上传，以完成平台间数据的互联互通。数据交换架构如图1所示：图1 数据交换架构图 5 接口基本规定 接口协议类型 5.1 数据接口协议统一采用HTTP协议,接口请求方式为POST请求，采用同步方式进行。接口交换格式 5.2 接口交换格式采用JSON传输数据，具备通用性和可扩展性。接口协议内容 5.3 关于接口规范的数据清单应符合附录A的规定。2 DB 34/T 41412022 附录A （规范性）电梯应急救援平台数据接口规范 A.1 省电梯平台对外提供服务的数据接口 A.1.1 数据字典接口服务 A.1.1.1 接口方法及说明 接口标识符：Dict。接口说明：用于获取省电梯平台内的数据字典信息。A.1.1.2 接口输入参数及说明 省电梯平台提供的数据字典接口的输入参数及说明见表A.1。表A.1 省电梯平台数据字典接口输入参数及说明 输入参数名 类型 非空 参数描述 type String 是 字典类型,传入不同的 type 值获取不同的数据字典。电梯类别：EQU_TYPE；电梯品种：EQU_KIND；救援类型：MT_TYPE；故障类型：FALT_TYPE；AREA_CODE：区域字典。Page Int 否 页数（默认为 1）Rows Int 否 每页显示数（默认为 10）A.1.1.3 接口返回参数及说明 省电梯平台提供的数据字典接口的返回参数及说明见表A.2。表A.2 省电梯平台数据字典接口返回参数及说明 返回参数 类型 非空 字段描述 Data Label String 是 数据字段编码 Value String 是 数据值 Type String 是 字段类型 Description String 是 数据字段描述 ParentValue String 否 父级字段数据值 A.1.2 电梯设备信息接口 A.1.2.1 接口方法及说明 接口标识符：DtList。接口说明：本接口用于获取电梯基础信息数据。A.1.2.2 接口输入参数及说明 电梯基础信息接口的输入参数及说明见表A.3。3 DB 34/T 41412022 表A.3 电梯基础信息接口输入参数及说明 参数名 类型 非空 参数描述 EquDataSysID String 否 设备系统内 ID EquCardNo String 否 电梯唯一标识 EquCode String 否 设备代码 equregcode String 否 设备注册代码 ProNo String 否 产品编号(出厂编号)UseCarNo String 否 使用证编号 equlocarecode String 否 设备所在地区(县)字段编码 MtorgName String 否 维保单位名称 UseOrgName String 否 使用单位名称 porgaoname String 否 制造单位名称 buiorgname String 否 安装单位名称 Page Int 否 页数（默认为 1）Rows Int 否 每页显示数（默认为 10）A.1.2.3 接口返回参数及说明 电梯基础信息返回参数及说明见表A.4。表A.4 电梯基础信息接口返回参数及说明 返回参数 字段类型 非空 字段描述 Data EquDataSysID String 是 设备系统内 ID EquCardNo String 否 电梯唯一标识编号 EquCode String 是 设备代码 EquRegCode String 是 设备注册代码 EquClaCode String 是 设备种类编码 EquKindCode String 是 设备类别编码 EquVart String 是 设备品种编码 EquipName String 是 设备名称 EquipModel String 是 设备型号 ProNo String 是 产品编号(出厂编号)UseCarNo String 是 使用证编号 IssuecerDate String 是 最新发证日期（yyyy-MM-dd）RegOrgCode String 是 注册登记机构名称 4 DB 34/T 41412022 表 A.4 电梯基础信息接口返回参数及说明（续）返回参数 字段类型 非空 字段描述 Data RegNo String 是 登记表编号 EquLogCode String 是 设备注册字段编码 LoginState String 是 注册状态 UseStatus String 是 使用状态 IsInsurance String 否 是否购置保险 EquLocareCode String 是 设备所在地区(县)字段编码 EquLocareName String 是 设备所在地区(县)名称 EquLocareInfo String 是 设备详细地址 EquOrgNo String 是 设备单位内部编号 MtorgName String 是 维保单位名称 MtOrgLinman String 是 维保单位联系人 MtOrgLintel String 是 维保单位联系电话 MtPrgAdd String 是 维保单位地址 MtDeadLine String 是 维保合同截止时间（yyyy-MM-dd）UseOrgName String 是 使用单位名称 UseOrgAdd String 是 使用单位地址 EconoTypeCode String 是 单位经济类型 UseOrgLinman String 是 使用单位联系人 UseOrgLintel String 是 使用单位联系电话 EquUseDate String 是 设备投用日期（yyyy-MM-dd）porgaoname String 是 制造单位名称 BuiOrgName String 是 安装单位名称 EqubuiapDate String 是 设备安装日期（yyyy-MM-dd）lastInspectorgname String 是 最新检验机构名称 lastInspecttype String 是 最近检验类型 LastInspecttime String 是 最近检验日期（yyyy-MM-dd）LastInspectresult String 是 最近检验结论 LocationInfo String 是 坐标系及地理信息描述等，其形式以逗号作为分隔符，如“WGS84”，坐标系有：WGS84、CGCS2000、西安 80、北京 54、其他 Longitude String 是 所在经度 Latitude String 是 所在维度 MainStrForm String 否 主体结构形式 ManageMode String 否 管理方式 EleMoveSpeed Float 否 电梯运行速度 Eleratingload Float 否 电梯额定载荷 5 DB 34/T 41412022 表A.4 电梯基础信息接口返回参数及说明（续）返回参数 字段类型 非空 字段描述 Data Elefloor String 否 电梯层站 Eleheight Float 否 电梯提升高度（m）Tracangtype String 否 曳引机型号 Tracangleafacnumber String 否 曳引机出厂编号 ElectType String 否 电动机型号 ElectLeafacNumber String 否 电动机出厂编号 ElectRoPower Float 否 电动机功率（MW）ConscrType String 否 控制屏型号 ContscrCode String 否 控制屏出厂编号 RestSpeedType String 否 限速器型号 RestSpleafacNumber String 否 限速器出厂编号 Ladincangle Float 否 扶梯倾斜角（）Rundlebreadth Float 否 梯级宽度（m）ElewalkDistance Float 否 电梯走行距离（m）EleStadeNumber Int 否 电梯站数 EleFloorNumber Int 否 电梯层数 EleDoorNumber Int 否 电梯门数 RatedSpeed Float 否 额定速度 BlastProofFormLevel String 否 防爆等级 BlastProofForm String 否 防爆形式 SeneRunMode String 否 节能运行方式 ContrMode String 否 控制方式 StartMode String 否 启动方式 Passennumb Int 否 乘客人数 RoomLength Float 否 机房长（m）RoomHeight Float 否 机房高（m）RoomWidth Float 否 机房宽（m）roomform String 否 机房形式 BinLength Float 否 轿箱长（m）BinHeight Float 否 轿箱高（m）BinWidth Float 否 轿箱宽（m）DoorPattern String 否 门型式 Balaquot String 否 平衡系数 DragMode String 否 拖动方式 PullPower Float 否 拖动功率（MW）FireControlForm String 否 消防形式 Ropewrapmode String 否 曳引绳绕绳方式 6 D