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

该【DB52 T 1669.2-2022气瓶质量安全追溯系统第2部分：数据接口 】是由【书籍1243595614】上传分享，文档一共【13】页，该文档可以免费在线阅读，需要了解更多关于【DB52 T 1669.2-2022气瓶质量安全追溯系统第2部分：数据接口 】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。 : .
   
ICS
CCS K 009
5 22
贵 州 省 地 方方 标 准
DB522/T —20222

气瓶瓶质量量安 全全追溯溯系统统
第第 2 部部分：数据接口
Quality and saffety tracceability systemm for gass cylinder—
Part 2：Data interfacce



2022 -- 05 - 31 发发布 2022 - 009 - 01 实实施
贵贵州省市场场监督管理理局 发发 布
: .
DB52/T —2022

气瓶质量安全追溯系统 第 2 部分：数据接口
1 范围
本文件规定了气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数。
本文件适用于液化石油气气瓶和液化二甲醚气瓶的气瓶质量安全追溯系统的数据接口。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，
仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本
文件。
GB/T 13000 信息技术 通用多八位编码字符集（UCS）
RFC 2616 （Hypertext Transfer Protocol—HTTP/）
RFC 4627 JSON应用与媒体类型 [The application/json Media Type for JavaScript Object
Notation(JSON)]
3 术语和定义
下列术语和定义适用于本文件。

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

编码字符集
一组明确的规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。
[来源：GB/T 1988-1998，]
4 缩略语
下列缩略语适用于本文件。
GTM：格林威治时间（Greenwich Mean Time ）
HTML：超文本置标语言（Hyper Text Markup Language ）
HTTP：超文本传输协议（Hyper Text Transfer Protocol ）
HTTPS：超文本传输安全协 议（Hyper Text Transfer Protocol over Secure Socket Layer 或
Hypertext Transfer Protocol Secure）
ID：标识符（Identifier ）
JSON：轻量级的数据交换格式（JavaScript Object Notation ）
MIME：多用途互联网邮件扩展（Multipurpose Internet Mail Extensions ）
1 : .
DB52/T —2022
5 总体要求
通信协议
应采用符合RFC 2616的HTTP或HTTPS。
接口描述
宜使用标准化的或比较通用的文本描述语言，如JSON（RFC4627）。
编码字符集
应符合GB/T 13000的要求。
数据类型
气瓶质量安全追溯系统数据接口应覆盖所能支持数据类型，包括：
—— 字符串型（String）；
—— 数字型（Number）；
—— 时间型（DateTime）；
—— 对象型（Object）；
—— 数组型（Array）；
—— 布尔型（Boolean）；
—— 空（NULL）。
注： 对“时间”类信息，以“1970年1月1日，00:00:00（GTM时间）”作为基准起始时间。
6 接口消息格式
请求消息格式
消息格式
请求消息由请求头和请求参数组成。应使用HTTP规定的POST请求方法。
请求头
不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。
表1 请求头
名称 描述 必选/可选
Host 指定请求的服务器的域名和端口号 必选
Connection 表示是否需要持久连接 必选
Accept 表示接受所接收的内容类型 必选
Content-Type 请求的与实体对应的MIME信息 必选
Content-Lentgh 请求的内容长度 必选


2 : .
DB52/T —2022
表 1 （续）
名称 描述 必选/可选
HTTP请求发送时，会把保存在该请求域名下的所有cookie
Cookie 可选
值一起发送给网站服务器
User-Agent 内容包含发出请求的用户信息 可选
Token 访问连接的密钥信息 可选
请求参数
请求参数格式见示例列表形式，根据不同接口功能，其请求参数不同。
示例：
参数名 数据类型 必选/可选 描述
给出该字段所代表的参数名 用于描述数据的数据类型 描述该参数是否为必选 对参数的描述及补充说明
- - - -
响应消息格式
消息格式
响应消息由响应头和响应消息参数组成。应使用HTTP规定的POST 请求方法。
响应头
不同接口具有同一响应头，响应头的名称及其含义描述应符合表2的规定。
表2 响应头
名称 描述 必选/可选
Content-Type 请求的与实体对应的MIME信息 必选
Content-Length 请求的内容长度 必选
Date 服务器消息发出的时间 可选
Server 服务器软件名称 可选
响应参数
响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数不同。
示例：
参数名 数据类型 必选/可选 描述
给出该字段所代表的参数名 用于描述数据的数据类型 描述该参数是否为必选 对参数的描述及补充说明
- - - -
7 接口基本功能和参数
接口流程
企业平台向监管平台上报数据或请求数据的接口流程应符合图1，接口的流程如下：
a) 企业平台发出请求，上报数据或请求数据；
b) 监管平台对该次请求进行处理；
3 : .
DB52/T —2022
c) 处理后由监管平台向企业平台返回处理结果。

图1 接口流程
初始化连通接口
功能
用于企业平台和监管平台间建立初始化连通。
请求参数
初始化连通请求参数应符合表3的规定。
表3 初始化连通请求参数
参数名 数据类型 必选/可选 描述
app_id String 必选 接入方ID
app_key String 必选 接入方功能板块信息
app_secret String 必选 接入方密钥
响应消息参数
初始化连通响应消息参数应符合表4的规定。
表4 初始化连通响应消息参数
参数名 数据类型 必选/可选 描述
status Number 必选 本次请求处理状态码
msg String 必选 本次请求处理结果描述
access_token String 必选 接入获取到的密钥
expries Number 必选 密钥过期时间
4 : .
DB52/T —2022
请求类接口
请求类接口列表
请求类接口列表应符合表5的规定。
表5 请求类接口列表
中文名称 英文名称 必选/可选
气瓶基本信息 product 必选
气瓶充装信息 fill 必选
气瓶检验信息 check 可选
气瓶信息化标签信息 tag 可选
请求类接口基本功能和参数
气瓶基本信息
功能
用于企业平台查询监管平台内气瓶基本信息。
请求参数
气瓶基本信息请求参数应符合表6的规定。
表6 气瓶基本信息请求参数
参数名 数据类型 必选/可选 描述
inner_code String 必选 查询气瓶的单位内编码
响应消息参数
气瓶基本信息响应信息参数应符合表7的规定。
表7 气瓶基本信息响应消息参数
名称 数据类型 必选/可选 描述
pro_variety String 必选