DB34-T 4531-2023 安徽省气瓶质量安全追溯信息平台数据接口规范

ICS23.020.3034DB34/T4531—2023安徽省气瓶质量安全追溯信息平台数据接口规范Datainterfacespecificationforgascylinderinformationqualitytracingplatform2023-07-31发布2023-08-31实施安徽省市场监督管理局发布IDB34/T4531—2023前言 12规范性引用文件 13术语和定义 14缩略语 15数据交换架构 16接口基本要求 26.1接口协议类型 26.2接口交换格式 26.3接口数据类型 26.4接口消息格式 3附录A（规范性）接口规范的数据清单 4A.1市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口 4A.2市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口 9DB34/T4531—2023本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省特种设备检测院提出。本文件由安徽省市场监督管理局归口。本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。本文件主要起草人：莫诚生、赵龙、王仁涛、王彬彬、严伟、许佳伟、汪源、王启龙、熊钰才、程嘉良、张伟。DB34/T4531—20231安徽省气瓶质量安全追溯信息平台数据接口规范本文件规定了气瓶质量安全追溯信息平台的数据交换架构、接口基本规定、接口协议清单及内容。本文件适用于省气瓶信息质量追溯平台（以下简称“省气瓶追溯平台”）与各市级气瓶信息质量追溯平台（以下简称“市级气瓶追溯平台”）之间的数据交换。2规范性引用文件本文件没有规范性引用文件。3术语和定义本文件没有需要界定的术语和定义。4缩略语下列缩略语适用于本文件。JSON：JavaScript对象简谱（JavaScriptObjectNotation）。HTTP：超文本传输协议（HyperTextTransferProtocol）。HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）。5数据交换架构各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传，省气瓶追溯平台负责统一开发数据接口并进行维护更新，同时将数据同步到省大数据中心，以完成各平台间数据的互联互通。数据交换架构图见图1。DB34/T4531—20232图1数据交换架构图6接口基本要求6.1接口协议类型数据接口协议可采用HTTP或HTTPS协议,接口请求方式为POST请求，采用同步方式进行。6.2接口交换格式接口交换格式采用JSON传输数据，具备通用性和可扩展性。6.3接口数据类型接口数据类型包括：——字符串型（String）；——整数型（Int）；——小数型（Double——时间型（Date）。DB34/T4531—202336.4接口消息格式6.4.1请求消息格式消息格式：由请求头和请求参数组成。请求头：不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。请求参数：请求参数格式见表2列表形式，根据不同接口功能，其请求参数不同。表1接口请求头格式请求发送时，会把保存在该请求域名下的所有coo表2接口请求参数格式6.4.2响应消息格式消息格式：由响应头和响应参数组成。响应头：不同接口具有统一响应头，响应头的名称及其含义描述应符合表3的规定。响应参数：响应参数格式见表4列表形式，根据不同接口功能，其响应参数不同。表3接口响应头格式表4接口响应参数格式————6.4.3接口协议内容关于接口规范的数据清单按照附录A的规定执行。DB34/T4531—20234接口规范的数据清单A.1市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口A.1.1市级平台身份认证接口A.1.1.1接口方法及说明接口标识符：GetKey接口说明：本接口用于市级平台获取身份认证密钥。A.1.1.2接口输入参数及说明市级平台身份认证接口的输入参数及说明见表A.1。表A.1市级平台身份认证接口输入参数及说明是是A.1.1.3接口返回参数及说明市级平台身份认证接口返回参数及说明见表A.2。表A.2市级平台身份认证接口返回参数及说明是是是是是A.1.2气瓶使用登记信息接口（车用气瓶除外）A.1.2.1接口方法及说明接口标识符：Register_Cylinder接口说明：本接口用于查询气瓶的使用登记信息。A.1.2.2接口输入参数及说明气瓶使用登记信息接口的输入参数及说明见表A.3。DB34/T4531—20235表A.3气瓶使用登记信息接口输入参数及说明是否否否否A.1.2.3接口返回参数及说明气瓶使用登记信息返回参数及说明见表A.4。表A.4气瓶使用登记信息接口返回参数及说明是是是是是是是是是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-NominalWorkingPress是是是是是是否否是是是是DB34/T4531—20236表A.4（续）Data是是A.1.3车用气瓶使用登记信息接口A.1.3.1接口方法及说明接口标识符：CyRegister_Cylinder接口说明：本接口用于查询车用气瓶使用登记信息。A.1.3.2接口输入参数及说明车用气瓶使用登记气瓶信息接口的输入参数及说明见表A.5。表A.5车用气瓶使用登记信息接口输入参数及说明是否否否否否A.1.3.3接口返回参数及说明车用气瓶使用登记信息返回参数及说明见表A.6。表A.6车用气瓶使用登记信息接口返回参数及说明是是是否是使用单位名称是是是是DB34/T4531—20237表A.6（续）Data是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-NominalWorkingPress是是是是是是是是否否否否是是是A.1.4单位主体信息接口A.1.4.1接口方法及说明接口标识符：OrgInfo接口说明：本接口用于获取气瓶设计单位、制造单位、充装单位和检验单位信息。A.1.4.2接口输入参数及说明单位主体信息接口的输入参数及说明见表A.7。DB34/T4531—20238表A.7单位主体接口输入参数及说明是是装单位：j4：气瓶检验单位：j5：车用是否否否A.1.4.3接口返回参数及说明单位主体信息返回参数及说明见表A.8。表A.8单位主体信息接口返回参数及说明是是是是是是是是是是是是是是是是是是是A.1.5充装作业人员信息接口DB34/T4531—20239A.1.5.1接口方法及说明接口标识符：FillingStaff接口说明：本接口用于查询气瓶充装作业人员的信息。A.1.5.2接口输入参数及说明气瓶充装作业人员信息接口的输入参数及说明见表A.9。表A.9气瓶充装作业人员信息接口输入参数及说明是否否否否否否A.1.5.3接口返回参数及说明气瓶充装作业人员信息接口返回参数及说明见表A.10。表A.10表气瓶充装作业人员信息接口返回参数及说明是是是是是否否否否否是是A.2市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口A.2.1气瓶相关数据接口（车用气瓶除外）A.2.1.1气瓶档案上传接口A.接口方法及说明DB34/T4531—2023接口标识符：QpBaseInfo接口说明：该接口用于上传市级气瓶追溯平台的气瓶档案数据信息。A.接口输入参数及说明气瓶档案接口的输入参数及说明见表A.11。表A.11气瓶档案接口输入参数及说明是是是是是是是是是是是是是是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液NominalWorkingPress是是是是是是是是是是是否DB34/T4531—2023表A.11（续）Data否是是是A.接口返回参数及说明气瓶档案信息上传后的返回参数及说明见表A.12。表A.12气瓶档案信息接口返回参数及说明是是是是A.2.1.2气瓶瓶组信息上传接口A.接口方法及说明接口标识符：QpGroup接口说明：该接口用于上传市级气瓶追溯平台的气瓶瓶组数据信息。A.接口输入参数及说明工业气瓶瓶组接口的输入参数及说明见表A.13。表A.13气瓶瓶组信息接口输入参数及说明是是是否是是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液DB34/T4531—2023表A.13（续）是是是是A.接口返回参数及说明气瓶瓶组信息上传后的返回参数及说明见表A.14。表A.14气瓶瓶组信息接口返回参数及说明是是是是A.2.1.3气瓶充装信息上传接口A.接口方法及说明接口标识符：QpFillingCheckInfo接口说明：该接口用于上传气瓶的充装信息（包括充装记录和充装前、后检查记录）。A.接口输入参数及说明气瓶充装信息接口的输入参数及说明见表A.15。表A.15气瓶充装信息接口输入参数及说明是Data是是是是是是是DB34/T4531—2023表A.15（续）Data是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液是是是是是是是是是否是是是是是充后重量（实际值单位:kg）是是是是是是是否否是是是A.接口返回参数及说明气瓶充装信息返回参数及说明见表A.16。DB34/T4531—2023表A.16气瓶充装信息接口返回参数及说明是是是是A.2.1.4气瓶检验信息上传接口A.接口方法及说明接口标识符：QpInspectInfo接口说明：该接口用于上传气瓶的检验信息（包括检验报告和检验记录）。A.接口输入参数及说明气瓶检验信息接口的输入参数及说明见表A.17。表A.17气瓶检验信息接口输入参数及说明是Data是是是是是是是是是是是是是是是是是是是是是是DB34/T4531—2023A.接口返回参数及说明气瓶检验信息返回参数及说明见表A.18。表A.18气瓶检验记录信息接口返回参数及说明是是是是A.2.2车用气瓶相关数据接口A.2.2.1车用气瓶充装信息上传接口A.接口方法及说明接口标识符：CyqpFillingCheckInfo接口说明：该接口用于上传车用气瓶的充装信息（包括充装记录和充装检查记录）。A.接口输入参数及说明车用气瓶充装信息接口的输入参数及说明见表A.19。表A.19车用气瓶充装信息接口输入参数及说明是是是是否否是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液是是是是是是DB34/T4531—2023表A.19（续）是是是是是是是是是是是是A.接口返回参数及说明车用气瓶充装信息返回参数及说明见表A.20。表A.20车用气瓶充装信息接口返回参数及说明是是是是A.2.2.2车用气瓶检验信息上传接口A.接口方法及说明接口标识符：CyqpInspectInfo接口说明：该接口用于上传车用气瓶的检验信息。A.接口输入参数及说明车用气瓶检验信息接口的输入参数及说明见表A.21表A.21车用气瓶检验信息接口输入参数及说明是Data是是是是DB34/T4531—2023表A.21（续）Data是是是是否是是是是是是是是是是是否是是是是A.接口返回参数及说明车用气瓶检验信息返回参数及说明见表A.22。表A.22车