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

34 34 ICS 35.100 CCS L 79 安 徽 省 地 方 标 准 DB 34/T 4141—2022 电梯应急救援平台数据接口规范 Data interface specification for elevator emergency rescue platform 2022 - 03 - 29 发布 2022 - 04 - 29 实施 安徽省市场监督管理局 发 布 DB 34/T 4141 DB 34/T 4141—2022 I I 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省特种设备检测院提出。 本文件由安徽省市场监督管理局归口。 本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。 本文件主要起草人：莫诚生、赵龙、许迪、许佳伟、严伟、姚刚、王启龙、熊钰才、汪源、许路夷。 DB 34/T 4141 DB 34/T 4141—2022 DB 34/T 4141— DB 34/T 4141—2022 省电梯平台负责统一开发数据接口并进行维护更新，各地方电梯平台按照数据接口规范要求实现数 据下载和上传，以完成平台间数据的互联互通。数据交换架构如图1所示： PAGE PAGE 11 PAGE PAGE 10 电梯应急救援平台数据接口规范 范围 本文件规定了电梯应急救援平台的数据交换架构、接口基本规定、接口协议清单及内容。 本文件适用于省电梯应急救援管理平台（以下简称“省电梯平台”）与各地市或区县电梯应急救援管理平台（以下简称“地方电梯平台”）之间的数据交换。 规范性引用文件 本文件没有规范性引用文件。 术语和定义 下列术语和定义适用于本文件。 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），是一种请求-响应协议。 数据交换架构 图1 数据交换架构图 接口基本规定 接口协议类型 数据接口协议统一采用HTTP协议,接口请求方式为POST请求，采用同步方式进行。 接口交换格式 接口交换格式采用JSON传输数据，具备通用性和可扩展性。 接口协议内容 关于接口规范的数据清单应符合附录A的规定。 附 录 A （规范性） 电梯应急救援平台数据接口规范 省电梯平台对外提供服务的数据接口 数据字典接口服务 接口方法及说明 接口标识符：Dict。 接口说明：用于获取省电梯平台内的数据字典信息。 接口输入参数及说明 省电梯平台提供的数据字典接口的输入参数及说明见表A.1。 表A.1 省电梯平台数据字典接口输入参数及说明 输入参数名 类型 非空 参数描述 type String 是 字典类型, 传入不同的 type 值获取不同的数据字典。电梯类别：EQU_TYPE；电梯品种：EQU_KIND；救援类型：MT_TYPE； 故障类型：FALT_TYPE；AREA_CODE：区域字典。 Page Int 否 页数（默认为 1） Rows Int 否 每页显示数（默认为 10） 接口返回参数及说明 省电梯平台提供的数据字典接口的返回参数及说明见表A.2。 表A.2 省电梯平台数据字典接口返回参数及说明 返回参数 类型 非空 字段描述 Data Label String 是 数据字段编码 Value String 是 数据值 Type String 是 字段类型 Description String 是 数据字段描述 ParentValue String 否 父级字段数据值 电梯设备信息接口 接口方法及说明 接口标识符：DtList。