ICS 35.100 CCS L 79 34 安 徽 省 地 方 标 准 DB 34/T 4141—2022 电梯应急救援平台数据接口规范 Data interface specification for elevator emergency rescue platform 2022 - 03 - 29 发布 2022 - 04 - 29 实施 安徽省市场监督管理局 发 布 DB 34/T 4141—2022 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由安徽省特种设备检测院提出。 本文件由安徽省市场监督管理局归口。 本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。 本文件主要起草人：莫诚生、赵龙、许迪、许佳伟、严伟、姚刚、王启龙、熊钰才、汪源、许路夷。 I DB 34/T 4141—2022 电梯应急救援平台数据接口规范 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 4141—2022 省电梯平台负责统一开发数据接口并进行维护更新，各地方电梯平台按照数据接口规范要求实现数 据下载和上传，以完成平台间数据的互联互通。数据交换架构如图1所示： 图1 数据交换架构图 5 接口基本规定 5.1 接口协议类型 数据接口协议统一采用HTTP协议,接口请求方式为POST请求，采用同步方式进行。 5.2 接口交换格式 接口交换格式采用JSON传输数据，具备通用性和可扩展性。 5.3 接口协议内容 关于接口规范的数据清单应符合附录A的规定。 2 DB 34/T 4141—2022 附 录 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 4141—2022 表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 4 字段类型 非空 字段描述 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 是 注册登记机构名称 DB 34/T 4141—2022 表 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 4141—2022 表A.4 电梯基础信息接口返回参数及说明（续） 返回参数 Data 6 字段类型 非空 字段描述 Elefloor String 否 电梯层站 Eleheight Float 否 电梯提升高度（m） Tracangtype String