DB35/T 2084-2022 特种设备检验检测数据传输接口要求

ICS01.040.35

CCSL70

35

福建省地方标准

DB35/T2084—2022

特种设备检验检测数据传输接口要求

Requirementsofinspectiondatainterfaceforspecialequipment

2022-10-27发布2023-01-27实施

福建省市场监督管理局发布

DB35/T2084—2022

目次

前言.................................................................................II

1范围...............................................................................1

2规范性引用文件.....................................................................1

3术语和定义.........................................................................1

4缩略语.............................................................................2

5基本要求...........................................................................2

6接口要求...........................................................................2

7校验要求..........................................................................11

附录A（资料性）设备识别码代号......................................................12

附录B（规范性）特种设备检验检测传输接口数据加密要求................................13

附录C（资料性）特种设备检验检测数据传输接口JSONSchema示例........................14

附录D（规范性）数据项取值..........................................................22

参考文献.............................................................................29

I

DB35/T2084—2022

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由福建特种设备检验研究院提出。

本文件由福建省市场监督管理局归口。

本文件起草单位：福建省特种设备检验研究院。

本文件主要起草人：李伟程、陈崇钰、陈永阳、廖安、郑晓蓓、林玲、林娟、李人鉴、王芳、潘健鸿、

孙良艳。

II

DB35/T2084—2022

特种设备检验检测数据传输接口要求

1范围

本文件规定了特种设备检验检测数据传输接口的基本要求、接口要求和校验要求等。

本文件适用于特种设备检验检测机构、特种设备安全监察机构对检验检测数据传输接口的设计和应

用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T2260中华人民共和国行政区划代码

GB/T22239—2019信息安全技术网络安全等级保护基本要求

GB32100—2015法人和其他组织统一社会信用代码编码规则

GB/T33780.2—2017基于云计算的电子政务公共平台技术规范第2部分：功能和性能

GB/T38700—2020特种设备追溯系统数据元

GM/T0002SM4分组密码算法

GM/T0004SM3密码杂凑算法

RB/T214—2017检验检测机构资质认定能力评价检验检测机构通用要求

TSG11锅炉安全技术规程

TSG81场(厂)内专用机动车辆安全技术规程

TSGD7005压力管道定期检验规则——工业管道

TSGQ7016起重机械安装改造重大修理监督检验规则

TSGR7001压力容器定期检验规则

TSGS7001客运索道监督检验和定期检验规则

TSGT7001电梯监督检验和定期检验规则——曳引与强制驱动电梯

3术语和定义

GB/T32100—2015、RB/T214—2017界定的以及下列术语和定义适用于本文件。

3.1

设备识别码equipmentIDcode

特种设备安全监察机构用于标识某一特种设备而赋予的字母、数字编码。

注：设备识别码共9位，第1位字母表示设备种类代号，第2位字母表示设备所在辖区代号，第3至9位数字为流水号，

具体代号参见附录A。

3.2

访问令牌accesstoken

应用程序用来安全识别访问用户而随机生成的32位字母和数字不重复字符串信息。

1

DB35/T2084—2022

3.3

检验检测机构inspectionbodyandlaboratory

依法成立，依据相关标准或者技术规范，利用仪器设备、环境设施等技术条件和专业技能，对产品

或者法律法规规定的特定对象进行检验检测的专业技术组织。

[来源：RB/T214—2017，3.1]

4缩略语

下列缩略语适用于本文件。

API：应用程序编程接口（ApplicationProgrammingInterface）

HTTP：超文本传输协议（HyperTextTransferProtocol）

HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：轻量级的数据交换格式（JavaScriptObjectNotation）

REST：一种网络应用程序的设计风格和开发方式（RepresentationalStateTransfer）

SM3：SM3密码杂凑算法（SM3cryptographichashalgorithm）

SM4：SM4分组密码算法（SM4blockcipheralgorithm）

5基本要求

特种设备检验检测数据传输接口应满足如下要求：

a)传输协议采用HTTP/HTTPS；

b)消息的封装采用JSON格式；

c)提供服务请求的接口返回状态说明；

d)性能要求按照GB/T33780.2—2017中4.2的规定；

e)安全要求按照GB/T22239—2019中第8章的规定；

f)数据按照GM/T0004、GM/T0002中规定的SM3、SM4算法进行加密，数据加密要求按照附录B

的规定；

g)数据类型及格式要求按照GB/T38700—2020中4.4的规定；

h)主要技术参数的数值单位按照TSG11、TSG81、TSGD7005、TSGQ7016、TSGR7001、TSGS7001、

TSGT7001、国质检锅[2002]124号的规定执行。

6接口要求

6.1接口分类

特种设备检验检测数据传输接口主要包括：身份验证服务接口、检验检测数据查询接口、检验检测

数据上传接口。

6.2身份验证服务接口

数据提供方接入数据传输接口时，应调用身份验证服务接口进行身份认证，认证成功后返回授权访

问令牌。身份验证服务接口描述如下：

接口地址：IP地址:端口/…/service/auth。

接口类型：post。

2

DB35/T2084—2022

请求参数：见表1。

返回参数：见表2。

请求示例：见附录C的C.1.1。

返回示例：见附录C的C.1.2。

表1身份验证服务接口请求参数表

参数名称数据类型及格式是否必填说明

USERNAMEC..30是数据传输接口分配给数据提供方的用户名

数据传输接口分配给数据提供方的密码，应采用

PASSWDC..30是

GM/T0004的SM3密码杂凑算法编制

表2身份验证服务接口返回参数表

参数名称数据类型及格式说明

STATUSC..2接口返回状态码，数据项取值按照附录D的D.1规定

MSGC..200接口返回错误说明

TOKENC32访问令牌

6.3检验检测数据查询接口

6.3.1已使用登记特种设备信息查询

数据提供方通过本接口查询本单位检验检测的已使用登记特种设备信息。接口描述如下：

接口地址：IP地址:端口/…/service/api/regeqpquery。

接口类型：post。

请求参数：见表3。

返回参数：见表4。

请求示例：见附录C的C.2.1。

返回示例：见附录C的C.2.2。

表3已使用登记特种设备信息查询接口请求参数表

参数名称数据类型及格式是否必填说明

OIDNOC10是设备识别码

表4已使用登记特种设备信息查询接口返回参数表

参数名称数据类型及格式说明

STATUSC..2接口返回状态码，数据项取值按照附录D的D.1规定

MSGC..200接口返回错误说明

OIDNOC10设备识别码

FACTORY_CODC..50出厂编号

3

DB35/T2084—2022

表4已使用登记特种设备信息查询接口返回参数表（续）

参数名称数据类型及格式说明

EQP_MODC..50设备型号

EQP_NAMEC..50设备名称

EQP_TYPE_NAMEC..50设备种类，按照特种设备目录执行

EQP_SORT_NAMEC..50设备类别，按照特种设备目录执行

EQP_VART_NAMEC..50设备品种，按照特种设备目录执行

EQP_AREA_NAMEC6设备所在辖区，按照GB/T2260的规定执行

EQP_INNER_CODC..20单位内部编号

EQP_USE_ADDRC..100设备使用地点

MAKE_DATED制造日期，格式YYYY-MM-DD

EQP_USE_STA_NAMEC..20使用状态

USE_UNT_NAMEC..100使用单位

USE_LKMENC..20使用单位联系人

USE_PHONEN11使用单位联系人手机号

SAFE_MENC..20安全管理人员

SAFE_MEN_PHONEN11安全管理人员手机号

MANT_UNT_NAMEC..100维保单位

MANT_PHONEC..20维保电话

MAKE_UNT_NAMEC..100制造单位

INST_UNT_NAMEC..100安装单位

ALT_UNT_NAMEC..100改造单位

ISPUNT_NAMEC..100上次检验机构

LAST_ISP_DATE2_FMTD上次检验日期，格式为YYYY-MM-DD

LAST_ISP_CONCLU2C..200上次检验结论

LAST_ISP_REPORT2C..50上次检验报告编号

CHK_UNT_IDC..100上次检测机构

LAST_CHK_DATE_FMTD上次检测日期，格式为YYYY-MM-DD

LAST_CHK_CONCLUC..200上次检测结论

LAST_CHK_REPORTC..50上次检测报告编号

6.3.2未使用登记特种设备信息查询

数据提供方通过本接口查询已告知但未使用登记特种设备信息。接口描述如下：

接口地址：IP地址:端口/…/service/api/notregeqpquery。

接口类型：post。

请求参数：见表5。

返回参数：见表6。

请求示例：见附录C的C.3.1。

返回示例：见附录C的C.3.2。

4

DB35/T2084—2022

表5未使用登记特种设备信息查询接口请求参数表

参数名称数据类型及格式是否必填说明

USE_UNT_NAMEC..100是使用单位

OIDNOC10否设备识别码

NOTICE_CODC..20是施工告知受理编号

表6未使用登记特种设备信息查询接口返回参数表

参数名称数据类型及格式说明

STATUSC..2接口返回状态码，数据项取值按照附录D的D.1规定

MSGC..200接口返回错误说明

OIDNOC10设备识别码

FACTORY_CODC..50出厂编号

EQP_MODC..50设备型号

EQP_NAMEC..50设备名称

EQP_TYPE_NAMEC..50设备种类，按照特种设备目录执行

EQP_SORT_NAMEC..50设备类别，按照特种设备目录执行

EQP_VART_NAMEC..50设备品种，按照特种设备目录执行

EQP_AREA_NAMEC6设备所在辖区，按照GB/T2260的规定执行

EQP_INNER_CODC..20单位内部编号

EQP_USE_ADDRC..100设备使用地点

MAKE_DATED制造日期，格式为YYYY-MM-DD

USE_UNT_NAMEC..100使用单位

USE_UNT_CODC18使用单位统一社会信用代码，按照GB32100—2015的规定执行

USE_LKMENC..20使用单位联系人

USE_PHONEN11使用单位联系人手机号

MAKE_UNT_NAMEC..100制造单位

INST_UNT_NAMEC..100安装单位

ALT_UNT_NAMEC..100改造单位

6.4检验检测数据上传接口

数据提供方通过本接口上传特种设备检验检测数据。接口描述如下：

接口地址：IP地址:端口/…/service/api/ispinfo_submit。

接口类型：post。

请求参数：见表7。

返回参数：见表8。

请求示例：见附录C的C.4.1。

返回示例：见附录C的C.4.2。

5

DB35/T2084—2022

表7检验检测数据上传接口请求参数表

参数名称数据类型及格式是否必填说明

OIDNOC10是设备识别码

ISP_DATED是检验检测日期，格式为YYYY-MM-DD

NEXT_ISP_DATED是下次检验检测日期，格式为YYYY-MM-DD

ISP_ISPCODC..50是报告书编号

ISP_CONCLUC..200是检验检测结论

ISP_TYPE_CODC..5是检验检测类型，数据项取值按照附录D的D.2规定

ISP_MENC..20是检验（检测）员

NOTIFI_CODC..20否安装告知受理编号

REP_QUERY_ADDRC..300否报告书在线查询地址

USE_UNT_NAMEC..100是使用单位名称

使用单位统一社会信用代码，按照GB32100—2015的

USE_UNT_CODC18是

规定执行

USE_UNT_ADDRC..200是使用单位地址

EQP_NAMEC..50是设备名称

EQP_AREA_CODC6是设备所在区域，按照GB/T2260的规定执行

FACTORY_CODC..50是出厂编号

EQP_MODC..50是设备型号

EQP_INNER_CODC..20是单位内部编号

USE_LKMENC..20是设备联系人

LKMAN_PHONEN11是联系人手机号

EQP_USE_ADDRC..100是设备使用地点

MAKE_DATED是制造日期，格式为YYYY-MM-DD

MAKE_UNT_NAMEC..100是设备制造单位

MANT_UNT_NAMEC..100否维保单位名称

MANT_PHONEN11否维保电话

SAFE_MENC..20否安全管理人员

SAFE_MEN_PHONEN11否安全管理人员电话

ITEM_NOC..20否不合格项目编号

ITEM_NAMEC..200否不合格项目名称

DEFECT_TYPEC2否缺陷归类，数据项取值按照附录D的D.3规定

表8检验检测数据上传接口返回参数表

参数名称数据类型及格式说明

STATUSC..2接口返回状态码，数据项取值按照附录D的D.1规定

MSGC..200接口返回错误说明

6

DB35/T2084—2022

6.5主要技术参数数据上传接口

数据提供方通过该接口上传特种设备的主要技术参数数据。接口描述如下：

接口地址：IP地址:端口/…/service/api/eqppara_submit。

接口类型：post。

请求参数：见表9至表17。

返回参数：见表18。

请求示例：见附录C的C.5.1。

返回示例：见附录C的C.5.2。

表9锅炉关键主要参数数据上传接口请求参数

参数名称数据类型及格式是否必填说明

OIDNOC10是设备识别码

RATCONN..10.2是额定蒸发量/额定热功率

RATSTETEMN..10.2是额定温度

DESWORKPRESSN..10.2是额定压力

BURNINGTYPEN..2否燃料种类，数据项取值按照附录D的D.4规定

BURNMODEN..2否燃烧方式，数据项取值按照附录D的D.5规定

MAINSTRFORM