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

ICS23.020.30

CCSJ74

34

安徽省地方标准

DB34/T4531—2023

安徽省气瓶质量安全追溯信息平台

数据接口规范

Datainterfacespecificationforgascylinderinformationqualitytracingplatform

2023-07-31发布2023-08-31实施

安徽省市场监督管理局发布

DB34/T4531—2023

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

4缩略语1

5数据交换架构1

6接口基本要求2

6.1接口协议类型2

6.2接口交换格式2

6.3接口数据类型2

6.4接口消息格式3

附录A（规范性）接口规范的数据清单4

A.1市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口4

A.2市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口9

I

DB34/T4531—2023

前言

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

起草。

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

本文件由安徽省特种设备检测院提出。

本文件由安徽省市场监督管理局归口。

本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。

本文件主要起草人：莫诚生、赵龙、王仁涛、王彬彬、严伟、许佳伟、汪源、王启龙、熊钰才、程

嘉良、张伟。

II

DB34/T4531—2023

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

1范围

本文件规定了气瓶质量安全追溯信息平台的数据交换架构、接口基本规定、接口协议清单及内容。

本文件适用于省气瓶信息质量追溯平台（以下简称“省气瓶追溯平台”）与各市级气瓶信息质量追

溯平台（以下简称“市级气瓶追溯平台”）之间的数据交换。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

本文件没有需要界定的术语和定义。

4缩略语

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

JSON：JavaScript对象简谱（JavaScriptObjectNotation）。

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

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

5数据交换架构

各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传，省气瓶追溯平台负责统一

开发数据接口并进行维护更新，同时将数据同步到省大数据中心，以完成各平台间数据的互联互通。数

据交换架构图见图1。

1

DB34/T4531—2023

图1数据交换架构图

6接口基本要求

6.1接口协议类型

数据接口协议可采用HTTP或HTTPS协议,接口请求方式为POST请求，采用同步方式进行。

6.2接口交换格式

接口交换格式采用JSON传输数据，具备通用性和可扩展性。

6.3接口数据类型

接口数据类型包括：

——字符串型（String）；

——整数型（Int）；

——小数型（Double）；

——时间型（Date）。

注：对“时间”类信息，以“1970年1月1日，00:00:00（GTM时间）”作为基准起始时间。

2

DB34/T4531—2023

6.4接口消息格式

6.4.1请求消息格式

消息格式：由请求头和请求参数组成。

请求头：不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。

请求参数：请求参数格式见表2列表形式，根据不同接口功能，其请求参数不同。

表1接口请求头格式

名称描述必选/可选

Host指定请求的服务器的域名和端口号必选

Connection表示是否需要持久链接必选

Accept标识接受所接收的内容类型必选

Content-Type请求的与实体对应的MIME信息必选

Content-Lentgh请求的内容长度必选

Cookie请求发送时，会把保存在该请求域名下的所有cookie值一起发送给网站服务器可选

User-Agent内容包含发出请求的用户信息可选

Token访问连接的秘钥信息可选

表2接口请求参数格式

参数名类型非空参数描述

给出该字段所代表的的参数名用于描述数据的数据类型描述该参数是否可以为空对参数的描述及补充说明

————

6.4.2响应消息格式

消息格式：由响应头和响应参数组成。

响应头：不同接口具有统一响应头，响应头的名称及其含义描述应符合表3的规定。

响应参数：响应参数格式见表4列表形式，根据不同接口功能，其响应参数不同。

表3接口响应头格式

名称描述必选/可选

Content-Type请求的与实体对应的MIME信息必选

Content-Lentgh请求的内容长度必选

Date服务器消息发出的时间可选

Server服务器软件名称可选

表4接口响应参数格式

参数名类型非空参数描述

给出该字段所代表的的参数名用于描述数据的数据类型描述该参数是否可以为空对参数的描述及补充说明

————

6.4.3接口协议内容

关于接口规范的数据清单按照附录A的规定执行。

3

DB34/T4531—2023

A

A

附录A

（规范性）

接口规范的数据清单

A.1市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口

A.1.1市级平台身份认证接口

A.1.1.1接口方法及说明

接口标识符：GetKey

接口说明：本接口用于市级平台获取身份认证密钥。

A.1.1.2接口输入参数及说明

市级平台身份认证接口的输入参数及说明见表A.1。

表A.1市级平台身份认证接口输入参数及说明

参数名类型非空参数描述

appCodeString是接入平台ID

authCodeString是接入方密钥

A.1.1.3接口返回参数及说明

市级平台身份认证接口返回参数及说明见表A.2。

表A.2市级平台身份认证接口返回参数及说明

参数名类型非空参数描述

KeyString是身份认证密钥，调用业务接口时使用

Data

ExpireString是密钥过期时间（单位：秒）

StatusString是响应状态码

RtMsgString是响应状态描述

FromSystemString是源系统名称

A.1.2气瓶使用登记信息接口（车用气瓶除外）

A.1.2.1接口方法及说明

接口标识符：Register_Cylinder

接口说明：本接口用于查询气瓶的使用登记信息。

A.1.2.2接口输入参数及说明

气瓶使用登记信息接口的输入参数及说明见表A.3。

4

DB34/T4531—2023

表A.3气瓶使用登记信息接口输入参数及说明

参数名类型非空参数描述

KeyString是身份密钥

CertNoString否使用登记证编号

ProNoString否气瓶编号

PageInt否页数（默认为1）

RowsInt否每页显示数（默认为10）

A.1.2.3接口返回参数及说明

气瓶使用登记信息返回参数及说明见表A.4。

表A.4气瓶使用登记信息接口返回参数及说明

返回参数类型非空字段描述

UnitNameString是产权单位名称

ContactStaffString是产权单位联系人

ContactNumberString是产权单位联系电话

IsImportString是是否进口（0-是,1-否）

设备品种（t1-无缝气瓶，t2焊接气瓶，t3-内装填料气

EquVarietyString是

瓶，t4-纤维缠绕气瓶，t5-低温绝热气瓶）

ProNoString是气瓶编号

ProduceUnitString是制造单位名称或代号

ProduceDateDate是制造日期（yyyy-mm）

充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-

氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-

氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-

FillingMediumString是

液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-

液氧，JZ17液氮，JZ18-LNG，JZ19-CNG，JZ20-混合气，

Data

JZ21-液化石油气，JZ22-其他）

NominalWorkingPressureDouble是公称工作压力（单位:MPa）

VolumnDouble是公称容积（单位:L）

DesignWallThicknessString是设计壁厚（单位:mm）

LastCheckUnitString是最近检验机构

LastCheckDateDate是最近检验日期(yyyy-mm)

NextCheckDateDate是下次检验日期(yyyy-mm)

RegisUnitString否登记机关（发证机关）

RegisUserString否登记人员（发证人员）

UseStatString是变更或停用情况（s1-在用,s2-停用,s3-注销,s4-报废）

标签类型（t1-二维码标签,t2-电子标签,t3-智能角

TagTypeString是

阀,t4-其他,t5-无）

TagNoString是标签编号

CertNoString是使用登记证编号

5

DB34/T4531—2023

表A.4（续）

返回参数类型非空字段描述

CreateTimeDate是录入时间(yyyy-MM-ddHH:mm:ss)

Data

UpDateTimeDate是更新时间(yyyy-MM-ddHH:mm:ss)

A.1.3车用气瓶使用登记信息接口

A.1.3.1接口方法及说明

接口标识符：CyRegister_Cylinder

接口说明：本接口用于查询车用气瓶使用登记信息。

A.1.3.2接口输入参数及说明

车用气瓶使用登记气瓶信息接口的输入参数及说明见表A.5。

表A.5车用气瓶使用登记信息接口输入参数及说明

参数名类型非空参数描述

KeyString是身份密钥

CertNoString否使用登记证编号

CarNumberString否车牌号

ProNoString否气瓶编号

PageInt否页数（默认为1）

RowsInt否每页显示数（默认为10）

A.1.3.3接口返回参数及说明

车用气瓶使用登记信息返回参数及说明见表A.6。

表A.6车用气瓶使用登记信息接口返回参数及说明

返回参数类型非空字段描述

CylinderIdString是系统内主键Id

CarNumberString是车牌号

CarVinNumberString是车辆VIN码

CarProduceUnitString否车辆制造单位

UseUnitString是使用单位名称

Data

UseUnitContactStaffString是使用单位联系人

UseUnitContactTelString是使用单位联系电话

ProNoString是气瓶编号

设备品种（t1-无缝气瓶，t2焊接气瓶，t3-内装填料气

EquVarietyString是

瓶，t4-纤维缠绕气瓶，t5-低温绝热气瓶）

6

DB34/T4531—2023

表A.6（续）

返回参数类型非空字段描述

充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-

氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-

氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-

FillingMediumString是

液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-

液氧，JZ17液氮，JZ18-LNG，JZ19-CNG，JZ20-混合气，

JZ21-液化