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

ICS23.020.30CCSJ74

34

安徽省地方标准

DB34/T4531—2023

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

数据接口规范

Datainterfacespecificationforgascylinderinformationqualitytracingplatform

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

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

I

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

II

DB34/T4531—2023

前言

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

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

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

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

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

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

DB34/T4531—2023

1

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

1范围

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

本文件适用于省气瓶信息质量追溯平台（以下简称“省气瓶追溯平台”）与各市级气瓶信息质量追溯平台（以下简称“市级气瓶追溯平台”）之间的数据交换。

2规范性引用文件

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

3术语和定义

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

4缩略语

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

JSON：JavaScript对象简谱（JavaScriptObjectNotation）。

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

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

5数据交换架构

各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传，省气瓶追溯平台负责统一开发数据接口并进行维护更新，同时将数据同步到省大数据中心，以完成各平台间数据的互联互通。数据交换架构图见图1。

DB34/T4531—2023

2

图1数据交换架构图

6接口基本要求

6.1接口协议类型

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

6.2接口交换格式

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

6.3接口数据类型

接口数据类型包括：

——字符串型（String）；

——整数型（Int）；

——小数型（Double）；

——时间型（Date）。

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

DB34/T4531—2023

3

6.4接口消息格式

6.4.1请求消息格式

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

请求头：不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。请求参数：请求参数格式见表2列表形式，根据不同接口功能，其请求参数不同。

表1接口请求头格式

名称

描述

必选/可选

Host

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

必选

Connection

表示是否需要持久链接

必选

Accept

标识接受所接收的内容类型

必选

Content-Type

请求的与实体对应的MIME信息

必选

Content-Lentgh

请求的内容长度

必选

Cookie

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

可选

User-Agent

内容包含发出请求的用户信息

可选

Token

访问连接的秘钥信息

可选

表2接口请求参数格式

参数名

类