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

特种设备检验检测数据传输接口要求 目 次 前言 II 1 范围 1 2 规范性引用文件 1 3 术语和定义 1 4 缩略语 2 5 基本要求 2 6 接口要求 2 7 校验要求 11 附录 A（资料性） 设备识别码代号 12 附录 B（规范性） 特种设备检验检测传输接口数据加密要求 13 附录 C（资料性） 特种设备检验检测数据传输接口 JSON Schema 示例 14 附录 D（规范性） 数据项取值 22 参考文献 29 I 特种设备检验检测数据传输接口要求 1 范围 本文件规定了特种设备检验检测数据传输接口的基本要求、接口要求和校验要求等。 本文件适用于特种设备检验检测机构、特种设备安全监察机构对检验检测数据传输接口的设计和应用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 2260 中华人民共和国行政区划代码 GB/T 22239—2019 信息安全技术 网络安全等级保护基本要求GB 32100—2015 法人和其他组织统一社会信用代码编码规则 GB/T 33780.2—2017 基于云计算的电子政务公共平台技术规范 第2部分：功能和性能GB/T 38700—2020 特种设备追溯系统数据元 GM/T 0002 SM4分组密码算法 GM/T 0004 SM3密码杂凑算法 RB/T 214—2017 检验检测机构资质认定能力评价 检验检测机构通用要求TSG 11 锅炉安全技术规程 TSG 81 场(厂)内专用机动车辆安全技术规程 TSG D7005 压力管道定期检验规则——工业管道 TSG Q7016 起重机械安装改造重大修理监督检验规则TSG R7001 压力容器定期检验规则 TSG S7001 客运索道监督检验和定期检验规则 TSG T7001 电梯监督检验和定期检验规则——曳引与强制驱动电梯 3 术语和定义 GB/T 32100—2015、RB/T 214—2017界定的以及下列术语和定义适用于本文件。 3.1 设备识别码 equipment ID code 特种设备安全监察机构用于标识某一特种设备而赋予的字母、数字编码。 注：设备识别码共9位，第1位字母表示设备种类代号，第2位字母表示设备所在辖区代号，第3至9位数字为流水号， 具体代号参见附录A。 3.2 访问令牌 access token 应用程序用来安全识别访问用户而随机生成的32位字母和数字不重复字符串信息。 1 3.3 检验检测机构 inspection body and laboratory 依法成立，依据相关标准或者技术规范，利用仪器设备、环境设施等技术条件和专业技能，对产品 或者法律法规规定的特定对象进行检验检测的专业技术组织。[来源：RB/T 214—2017，3.1] 4 缩略语 下列缩略语适用于本文件。 API：应用程序编程接口（Application Programming Interface） HTTP：超文本传输协议（Hyper Text Transfer Protocol） HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over Secure Socket Layer） JSON：轻量级的数据交换格式（JavaScript Object Notation） REST：一种网络应用程序的设计风格和开发方式（Representational State Transfer） SM3：SM3密码杂凑算法（SM3 cryptographic hash algorithm） SM4：SM4分组密码算法（SM4 block cipher algorithm） 5 基本要求 特种设备检验检测数据传输接口应满足如下要求： a) 传输协议采用 HTTP/HTTPS； b) 消息的封装采用 JSON 格式； c) 提供服务请求的接口返回状态说明； d) 性能要求按照 GB/T 33780.2—2017 中 4.2 的规定； e) 安全要求按照 GB/T 22239—2019 中第 8 章的规定； f) 数据按照 GM/T 0004、GM/T 0002 中规定的 SM3、SM4 算法进行加密，数据加密要求按照附录 B 的规定； g) 数据类型及格式要求按照 GB/T 38700—2020 中 4.4 的规定； h) 主要技术参数的数值单位按照 TSG 11、TSG 81、TSG D7005、TSG Q7016、TSG R7001、TSG S7001、TSG T7001、国质检锅[2002]124 号的规定执行。 6 接口要求 6.1 接口分类 特种设备检验检测数据传输接口主要包括：身份验证服务接口、检验检测数据查询接口、检验检测数据上传接口。 6.2 身份验证服务接口 数据提供方接入数据传输接口时，应调用身份验证服务接口进行身份认证，认证成功后返回授权访问令牌。身份验证服务接口描述如下： 接口地址：IP地址:端口/…/service/auth。接口类型：post。 2 请求参数：见表1。返回参数：见表2。 请求示例：见附录C的C.1.1。返回示例：见附录C的C.1.2。 表1 身份验证服务接口请求参数表 参数名称 数据类型及格式 是否必填 说明 USERNAME C..30 是 数据传输接口分配给数据提供方的用户名 PASSWD C..30 是 数据传输接口分配给数据提供方的密码，应采用 GM/T 0004的SM3密码杂凑算法编制 表2 身份验证服务接口返回参数表 参数名称 数据类型及格式 说明 STATUS C..2 接口返回状态码，数据项取值按照附录D的D.1规定 MSG C..200 接口返回错误说明 TOKEN C32 访问令牌 6.3 检验检测数据查询接口 6.3.1 已使用登记特种设备信息查询 数据提供方通过本接口查询本单位检验检测的已使用登记特种设备信息。接口描述如下： 接口地址：IP地址:端口/…/service/api/regeqpquery。 接口类型：post。请求参数：见表3。返回参数：见表4。 请求示例：见附录C的C.2.1。返回示例：见附录C的C.2.2。 表3 已使用登记特种设备信息查询接口请求参数表 参数名称 数据类型及格式 是否必填 说明 OIDNO C10 是 设备识别码 表4 已使用登记特种设备信息查询接口返回参数表 参数名称 数据类型及格式 说明 STATUS C..2 接口返回状态码，数据项取值按照附录D的D.1规定 MSG C..200 接口返回错误说明 OIDNO C10 设备识别码 FACTORY_COD C..50 出厂编号 3 表4 已使用登记特种设备信息查询接口返回参数表（续） 参数名称 数据类型及格式 说明 EQP_MOD C..50 设备型号 EQP_NAME C..50 设备名称 EQP_TYPE_NAME C..50 设备种类，按照特种设备目录执行 EQP_SORT_NAME C..50 设备类别，按照特种设备目录执行 EQP_VART_NAME C..50 设备品种，按照特种设备目录执行 EQP_AREA_NAME C6 设备所在辖区，按照GB/T 2260的规定执行 EQP_INNER_COD C..20 单位内部编号 EQP_USE_ADDR C..100 设备使用地点 MAKE_DATE D 制造日期，格式YYYY-MM-DD EQP_USE_STA_NAME C..20 使用状态 USE_UNT_NAME C..100 使用单位 USE_LKMEN C..20 使用单位联系人 USE_PHONE N11 使用单位联系人手机号 SAFE_MEN C..20 安全管理人员 SAFE_MEN_PHONE N11 安全管理人员手机号 MANT_UNT_NAME C..100 维保单位 MANT_PHONE C..20 维保电话 MAKE_UNT_NAME C..100 制造单位 INST_UNT_NAME C..100 安装单位 ALT_UNT_NAME C..100 改造单位 ISPUNT_NAME C..100 上次检验机构 LAST_ISP_DATE2_FMT D 上次检验日期，格式为YYYY-MM-DD LAST_ISP_CONCLU2 C..200 上次检验结论 LAST_ISP_REPORT2 C..50 上次检验报告编号 CHK_UNT_ID C..100 上次检测机构 LAST_CHK_DATE_FMT D 上次检测日期，格式为YYYY-MM-DD LAST_CHK_CONCLU C..200 上次检测结论 LAST_CHK_REPORT C..50 上次检测报告编号 6.3.2 未使用登记特种设备信息查询 数据提供方通过本接口查询已告知但未使用登记特种设备信息。接口描述如下： 接口地址：IP地址:端口/…/service/api/notregeqpquery。 接口类型：post。请求参数：见表5。返回参数：见表6。 请求示例：见附录C的C.3.1。返回示例：见附录C的C.3.2。 4 表5 未使用登记特种设备信息查询接口请求参数表 参数名称 数据类型及格式 是否必填 说明 USE_UNT_NAME C..100 是 使用单位 OIDNO C10 否 设备识别码 NOTICE_COD C..20 是 施工告知受理编号 表6 未使用登记特种设备信息查询接口返回参数表 参数名称 数据类型及格式 说明 STATUS C..2 接口返回状态码，数据项取值按照附录D的D.1规定 MSG C..200 接口返回错误说明 OIDNO C10 设备识别码 FACTORY_COD C..50 出厂编号 EQP_MOD C..50 设备型号 EQP_NAME C..50 设备名称 EQP_TYPE_NAME C..50 设备种类，按照特种设备目录执行 EQP_SORT_NAME C..50 设备类别，按照特种设备目录执行 EQP_VART_NAME C..50 设备品种，按照特种设备目录执行 EQP_AREA_NAME C6 设备所在辖区，按照GB/T 2260的规定执行 EQP_INNER_COD C..20 单位内部编号 EQP_USE_ADDR C..100 设备使用地点 MAKE_DATE D 制造日期，格式为YYYY-MM-DD USE_UNT_NAME C..100 使用单位 USE_UNT_COD C18 使用单位统一社会信用代码，按照GB