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

ICS01.040.3535DB35/T2084—2022特种设备检验检测数据传输接口要求Requirementsofinspectiondatainterfaceforspecialequipment2022-10-27发布2023-01-27实施福建省市场监督管理局发布IDB35/T2084—2022前言 12规范性引用文件 13术语和定义 14缩略语 25基本要求 26接口要求 27校验要求 附录A（资料性）设备识别码代号 附录B（规范性）特种设备检验检测传输接口数据加密要求 附录C（资料性）特种设备检验检测数据传输接口JSONSchema示例 附录D（规范性）数据项取值 参考文献 DB35/T2084—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建特种设备检验研究院提出。本文件由福建省市场监督管理局归口。本文件起草单位：福建省特种设备检验研究院。孙良艳。DB35/T2084—20221特种设备检验检测数据传输接口要求本文件规定了特种设备检验检测数据传输接口的基本要求、接口要求和校验要求等。本文件适用于特种设备检验检测机构、特种设备安全监察机构对检验检测数据传输接口的设计和应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特种设备安全监察机构用于标识某一特种设备而赋予的字母、数字编码。3.2访问令牌accesstoken应用程序用来安全识别访问用户而随机生成的32位字母和数字不重复字符串信息。2DB35/T2084—20223.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算法进行加密，数据加密要求按照附录Bg)数据类型及格式要求按照GB/T38700—2020中4.4的规定；h)主要技术参数的数值单位按照TSG11、TSG81、TSGD7005、TSGQ7016、TSGR7001、TSGS7001、TSGT7001、国质检锅[2002]124号的规定执行。6接口要求6.1接口分类特种设备检验检测数据传输接口主要包括：身份验证服务接口、检验检测数据查询接口、检验检测数据上传接口。6.2身份验证服务接口数据提供方接入数据传输接口时，应调用身份验证服务接口进行身份认证，认证成功后返回授权访问令牌。身份验证服务接口描述如下：接口地址：IP地址:端口/…/service/auth。接口类型：post。DB35/T2084—20223请求参数：见表1。返回参数：见表2。请求示例：见附录C的C.1.1。返回示例：见附录C的C.1.2。表1身份验证服务接口请求参数表是是表2身份验证服务接口返回参数表6.3检验检测数据查询接口6.3.1已使用登记特种设备信息查询数据提供方通过本接口查询本单位检验检测的已使用登记特种设备信息。接口描述如下：接口地址：IP地址:端口/…/service/api/regeqpquery。接口类型：post。请求参数：见表3。返回参数：见表4。请求示例：见附录C的C.2.1。返回示例：见附录C的C.2.2。表3已使用登记特种设备信息查询接口请求参数表是表4已使用登记特种设备信息查询接口返回参数表DB35/T2084—20224表4已使用登记特种设备信息查询接口返回参数表（续）DDD6.3.2未使用登记特种设备信息查询数据提供方通过本接口查询已告知但未使用登记特种设备信息。接口描述如下：接口地址：IP地址:端口/…/service/api/notregeqpquery。接口类型：post。请求参数：见表5。返回参数：见表6。请求示例：见附录C的C.3.1。返回示例：见附录C的C.3.2。DB35/T2084—20225表5未使用登记特种设备信息查询接口请求参数表是否是表6未使用登记特种设备信息查询接口返回参数表D6.4检验检测数据上传接口数据提供方通过本接口上传特种设备检验检测数据。接口描述如下：接口地址：IP地址:端口/…/service/api/ispinfo_submit。接口类型：post。请求参数：见表7。返回参数：见表8。请求示例：见附录C的C.4.1。返回示例：见附录C的C.4.2。DB35/T2084—20226表7检验检测数据上传接口请求参数表是D是D是是是是是否否是是是是是是是是是是是D是是否否否否否否否表8检验检测数据上传接口返回参数表DB35/T2084—202276.5主要技术参数数据上传接口数据提供方通过该接口上传特种设备的主要技术参数数据。接口描述如下：接口地址：IP地址:端口/…/service/api/eqppara_submit。接口类型：post。请求参数：见表9至表17。返回参数：见表18。请求示例：见附录C的C.5.1。返回示例：见附录C的C.5.2。表9锅炉关键主要参数数据上传接口请求参数是是是是否否否表10压力容器关键主要参数数据上传接口请求参数是是是是是是否否否否否否否否DB35/T2084—20228表11压力管道主要技术参数数据上传接口请求参数是是是是是是否否否否否否否表12电梯主要技术参数数据上传接口请求参数是是是是是是是否否是是否否否否否否否否DB35/T2084—20229表13起重机械（除升降机）主要技术参数数据上传接口请求参数是是否否否否是否否否否否否否否否否否否否表14升降机主要技术参数数据上传接口请求参数是是是是是是是是是DB35/T2084—2022表15场（厂）内专用机动车辆主要技术参数数据上传接口请求参数是是是是是否否否否表16大型游乐设施主要技术参数数据上传接口请求参数是否否是否是否否是表17客运索道关键主要参数数据上传接口请求参数是是是是否否表18主要技术参数数据上传接口返回参数表DB35/T2084—20227校验要求7.1身份校验数据提供方访问传输接口时，应在请求头部加入访问令牌信息以验证访问权限。验证通过后，可进行正常的会话交互。7.2数据校验传输接口应采用JSONSchema对请求的JSON数据进行校验，校验示例见附录C。DB35/T2084—2022设备识别码代号A.1特种设备种类代号特种设备种类代号见表A.1表A.1特种设备种类代号GRDTQNYSA.2特种设备所在辖区代号特种设备所在辖区代号见表A.2表A.2特种设备所在辖区代号ADECGBHFJKDB35/T2084—2022特种设备检验检测传输接口数据加密要求下面给出特种设备检验检测传输接口数据加密要求。如报文明文为rdata、特种设备检验检测数据提供方的账号为login_cod、账号密码为passwd。第一步：计算密钥key；key=SM3(login_cod+":"+passwd)第二步：根据密钥与SM4分组密码算法，生成密文encode_data。encode_data=SM4.ECB(rdata,key)DB35/T2084—2022特种设备检验检测数据传输接口JSONSchema示例C.1身份验证服务接口JSONSchema示例C.1.1身份验证服务接口请求JSONSchema示例下面给出身份验证服务接口JSONSchema示例。{examples:{}}C.1.2身份验证服务接口返回JSONSchema示例下面给出身份验证服务接口返回JSONSchema示例。{examples:{DB35/T2084—2022}}C.2查询已使用登记特种设备信息接口JSONSchema示例C.2.1查询已使用登记特种设备信息接口请求JSONSchema示例下面给出查询已使用登记特种设备信息接口请求JSONSchema示例。{examples:{}}C.2.2查询已使用登记特种设备信息接口返回JSONSchema示例下面给出查询已使用登记特种设备信息接口返回JSONSchema示例。{examples:{DB35/T2084—2022}}C.3查询未使用登记特种设备信息接口JSONSchema示例C.3.1查询未使用登记特种设备信息接口请求JSONSchema示例下面给出查询未使用登记特种设备信息接口请求JSONSchema示例。{DB35/T2084—2022{}}C.3.2查询未使用登记特种设备信息接口返回JSONSchema示例下面给出查询未使用登记特种设备信息接口返回JSONSchema示例。{examples:{DB35/T2084—2022}}C.4检验检测报告数据上传接口JSONSchema示例C.4.1检验检测数据上传接口请求JSONSchema示例下面给出提交检验检测数据上传接口请求JSONSchema示例。{DB35/T2084—2022"properties":{"ISP_MEN","REP_QUERY_ADDR","USE_UNT_NAME","USE_UNT_ADDR""EQP_MOD","EQP_INNER_COD","USE_LKMEN","LKMEN_PHONE","examples:{"NOT_ELIGIBLE_ITEMS":"[DB35/T2084—2022}}C.4.2检验检测数据上传接口返回JSONSchema示例下面给出提交检验检测数据上传接口返回JSONSchema示例。{examples:{}}C.5主要技术参数数据上传接口JSONSchema示例C.5.1主要技术参数数据上传接口请求JSONSchema示例下面给出主要技术参数数据上传接口请求JSONSchema示例。{{}}DB35/T2084—2022C.5.2主要技术参数数据上传接口返回JSONSchema示例下面给出主要技术参数数据上传接口返回JSONSchema示例。{examples:{}}DB35/T2084—2022数据项取值D.1接口返回状态码接口返回状态码见表D.1。表D.1接口返回状态码01D.2检验检测类型检验检测类型见表D.2。表D.2检验检测类型―――――――D.3缺陷归类缺陷归类见表D.3。表D.3缺陷归类DB35/T2084—2022表3缺陷归类（续）D.4燃料种类燃料种类见表D.4。表D.4燃料种类123456789DB35/T2084—2022D.5燃烧方式燃烧方式见表D.5。表D.5燃烧方式123456D.6工作介质工作介质见表D.6。表D.6工作介质12345678D.7安装形式安装形式见表D.7