DB52-T 1669.2-2022气瓶质量安全追溯系统第2部分：数据接口

ICS29.020

CCSK09

52

贵州省地方标准

DB52/T1669.2—2022

气瓶质量安全追溯系统

第2部分：数据接口

Qualityandsafetytraceabilitysystemforgascylinder—

Part2：Datainterface

2022-05-31发布2022-09-01实施

贵州省市场监督管理局发布

DB52/T1669.2—2022

气瓶质量安全追溯系统第2部分：数据接口

1范围

本文件规定了气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数。

本文件适用于液化石油气气瓶和液化二甲醚气瓶的气瓶质量安全追溯系统的数据接口。

2规范性引用文件

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

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

文件。

GB/T13000信息技术通用多八位编码字符集（UCS）

RFC2616超文本传输协议1.1（HypertextTransferProtocol—HTTP/1.1）

RFC4627JSON应用与媒体类型[Theapplication/jsonMediaTypeforJavaScriptObject

Notation(JSON)]

3术语和定义

下列术语和定义适用于本文件。

3.1

气瓶信息化标签

实现气瓶生命周期中充装验证和追溯的信息化媒介。

3.2

编码字符集

一组明确的规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。

[来源：GB/T1988-1998，4.6]

4缩略语

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

GTM：格林威治时间（GreenwichMeanTime）

HTML：超文本置标语言（HyperTextMarkupLanguage）

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

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

HypertextTransferProtocolSecure）

ID：标识符（Identifier）

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

MIME：多用途互联网邮件扩展（MultipurposeInternetMailExtensions）

1

DB52/T1669.2—2022

5总体要求

5.1通信协议

应采用符合RFC2616的HTTP或HTTPS。

5.2接口描述

宜使用标准化的或比较通用的文本描述语言，如JSON（RFC4627）。

5.3编码字符集

应符合GB/T13000的要求。

5.4数据类型

气瓶质量安全追溯系统数据接口应覆盖所能支持数据类型，包括：

——字符串型（String）；

——数字型（Number）；

——时间型（DateTime）；

——对象型（Object）；

——数组型（Array）；

——布尔型（Boolean）；

——空（NULL）。

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

6接口消息格式

6.1请求消息格式

6.1.1消息格式

请求消息由请求头和请求参数组成。应使用HTTP规定的POST请求方法。

6.1.2请求头

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

表1请求头

名称描述必选/可选

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

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

Accept表示接受所接收的内容类型必选

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

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

2

DB52/T1669.2—2022

表1（续）

名称描述必选/可选

HTTP请求发送时，会把保存在该请求域名下的所有cookie

Cookie可选

值一起发送给网站服务器

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

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

6.1.3请求参数

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

示例：

参数名数据类型必选/可选描述

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

----

6.2响应消息格式

6.2.1消息格式

响应消息由响应头和响应消息参数组成。应使用HTTP规定的POST请求方法。

6.2.2响应头

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

表2响应头

名称描述必选/可选

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

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

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

Server服务器软件名称可选

6.2.3响应参数

响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数不同。

示例：

参数名数据类型必选/可选描述

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

----

7接口基本功能和参数

7.1接口流程

企业平台向监管平台上报数据或请求数据的接口流程应符合图1，接口的流程如下：

a)企业平台发出请求，上报数据或请求数据；

b)监管平台对该次请求进行处理；

3

DB52/T1669.2—2022

c)处理后由监管平台向企业平台返回处理结果。

图1接口流程

7.2初始化连通接口

7.2.1功能

用于企业平台和监管平台间建立初始化连通。

7.2.2请求参数

初始化连通请求参数应符合表3的规定。

表3初始化连通请求参数

参数名数据类型必选/可选描述

app_idString必选接入方ID

app_keyString必选接入方功能板块信息

app_secretString必选接入方密钥

7.2.3响应消息参数

初始化连通响应消息参数应符合表4的规定。

表4初始化连通响应消息参数

参数名数据类型必选/可选描述

statusNumber必选本次请求处理状态码

msgString必选本次请求处理结果描述

access_tokenString必选接入获取到的密钥

expriesNumber必选密钥过期时间

4

DB52/T1669.2—2022

7.3请求类接口

7.3.1请求类接口列表

请求类接口列表应符合表5的规定。

表5请求类接口列表

中文名称英文名称必选/可选

气瓶基本信息product必选

气瓶充装信息fill必选

气瓶检验信息check可选

气瓶信息化标签信息tag可选

7.3.2请求类接口基本功能和参数

气瓶基本信息

.1功能

用于企业平台查询监管平台内气瓶基本信息。

.2请求参数

气瓶基本信息请求参数应符合表6的规定。

表6气瓶基本信息请求参数

参数名数据类型必选/可选描述

inner_codeString必选查询气瓶的单位内编码

.3响应消息参数

气瓶基本信息响应信息参数应符合表7的规定。

表7气瓶基本信息响应消息参数

名称数据类型必选/可选描述

pro_varietyString必选设备品种

pro_nameString必选产品名称

pro_noString必选气瓶生产编号

充装介质：0液化石油气，1二甲醚，2氧气，3二氧

fill_mediaNumber必选

化碳，4溶解乙炔

make_unitString必选制造单位

make_timeDateTime必选生产日期

work_pressureNumber必选公称工作压⼒（MPa）

volumeNumber必选容积（L）

check_timeDateTime必选最近⼒次检验⼒日期（新瓶该值填写出厂日期）

5

DB52/T1669.2—2022

表7（续）

名称数据类型必选/可选描述

下次检验日期（液化石油气瓶顺延4年气瓶下一次需

next_check_timeDateTime必选

要送检验站检验的日期）

regist_codeString可选气瓶使⽤登记代码

change_eventString可选变更情况（主要记录产权过户日志）

memoString可选备注

inner_codeString必选单位内编号

stamp_make_unitString可选气瓶钢印制造单位名称

pro_uuidString必选产品唯一性编码

chip_idString可选芯片id（每一个批次生成的登记证编号）

归属地（客户、门店、气站、检测机构）：0001门店，

locationString可选0002气站，0003企业，0004检验机构，005移动库，

006客户

气瓶状态[在用（已检测）、停用（待检测）、报废]：

statusString必选submit新瓶提交，using在用(已检测)，stop停用(待

检测)，scrapped报废

check_organizationString可选检测机构

empty_bottleBoolean必选是否空瓶：0是，1不是

product_idString可选产品类型ID

uidString可选高频编码

tidString可选超高频编码

chip_statusBoolean必选是否改造：0未改造，1已改造

location_source_idString可选当前归属机构ID

is_loseBoolean必选是否丢失：0丢失，1未丢失

old_bottleBoolean必选是否旧瓶

design_thicknessNumber必选设计壁厚

result_codeString可选检测结果

audit_remarkString可选审批备注

deadline_timeDateTime必选使用年限

check_in_timeDateTime必选录入日期

scrap_timeDateTime可选报废日期

统计状态值：inform已提交待审批，using在用，

analysis_statusString必选

scrapped报废

check_statusBoolean必选1已证，0未证

operation_idString必选操作人id

operation_timeDateTime必选操作时间

safe_evaluateBoolean必选安全评定

气瓶充装信息

.1功能

用于企业平台查询监管平台内气瓶最新一条充装信息。

6

DB52/T1669.2—2022

.2请求参数

气瓶充装信息请求参数应符合表8的规定。

表8气瓶充装信息请求参数

参数名数据类型必选/可选描述

inner_codeString必选查询气瓶的单位内编码

.3响应消息参数

气瓶充装信息响应消息参数应符合表9的规定。

表9气瓶充装信息响应消息参数

名称数据类型必选/可选说明

gun_codeString必选充装枪编号

station_idString必选充装气站ID

company_idString必选充装企业ID

areaString必选所在区

cityString必选所在市

person_codeString必选充装人员编码

user_idString必选充装人员id

inner_codeString必选单位内编号

chip_uidString必选高频编码

pro_uuidString必选气瓶uuid

product_idNumber必选产品类型id

product_media_idNumber必选充装介质编码

fill_timeDateTime必选充装时间

create_timeDateTime必选创建时间

气瓶定期检验信息

.1功能

用于企业平台查询监管平台内气瓶最新检验信息。

.2请求参数

气瓶定期检验信息请求参数应符合表10的规定。

表10气瓶定期检验信息请求参数

参数名数据类型必选/可选描述

order_noString必选气瓶检验订单编号

inner_codeString可选查询气瓶的单位内编码

.3响应消息参数

气瓶定期检验信息响应消息参数应符合表11的规定，气瓶定期检验明细应符合表12的规定。

7

DB52/T1669.2—2022

表11气瓶定期检验信息响应消息参数

名称数据类型必选/可选说明

security_personString必选安全管理员

unit_phoneString必选单位固定电话

pro_use_addressString必选设备使用单位地点

pro_numNumber必选设备数量

use_unit_addressString必选使用单位地址

use_unitString必选使用单位名称

use_unit_fill_personString必选使用单位填表人员

unit_social_codeString必选单位统一社会信用代码

use_unit_fill_dateDateTime必选填表日期

use_unit_phoneString必选移动电话

pro_listArray<Object>必选气瓶定期检验明细

表12气瓶定期检验明细

名称数据类型必选/可选说明

batch_noString必选登记编号

ori_bottle_statusString必选原气瓶状态

检验状态：0送检，1待绑定铭牌，2待绑定芯片，

check_statusNumber必选

3已绑定芯片，4报废，5气瓶退回，6气瓶丢失

deal_flagBoolean必选是否完成检验：0未完成，1已完成

is_safe_evaluateBoolean必选是否安全评定

next_check_timeDateTime可选下次检验日期

scrap_typeString可选报废处理方式

create_timeDateTime必选创建时间

check_timeDateTime必选检验时间

气瓶信息化标签信息

.1功能

用于企业平台查询监管平台内气瓶信息化标签信息。

.2请求参数

气瓶信息化标签信息请求参数应符合表13的规定。

表13气瓶信息化标签信息请求参数

参数名数据类型必选/可选描述

inner_codeString必选查询气瓶的单位内编码

8

DB52/T1669.2—2022

.3响应消息参数

气瓶信息化标签信息响应消息参数应符合表14的规定。

表14气瓶信息化标签信息响应消息参数

名称数据类型必选/可选说明

uidString可选高频编码

high_dataString可选高频芯片块数据

tidString可选超高频编码

ultra_high_dataString可选超高频块数据

union_idString必选关联id

qr_idString可选二维码id

chip_keyString可选秘钥

status_idBoolean必选绑定状态：0未绑定，1已绑定

company_idString可选生产厂家

create_timeDateTime必选入库时间

7.4上报类接口

7.4.1上报类接口列表

应符合表15的规定。

表15上报类接口列表

中文名称英文名称必选/可选

气瓶流转信息circulation必选

7.4.2上报类接口基本功能和参数

气瓶流转信息

.1功能

用于企业平台向监管平台上报气瓶信流转过程的信息，包括气瓶运输信息、气瓶仓储信息、气瓶配

送信息。

.2请求参数

气瓶流转信息请求参数应符合表16的规定。

表16气瓶流转信息请求参数

名称数据类型必选/可选说明

pro_uuidString必选气瓶uuid

9

DB52/T1669.2—2022

表16（续）

名称