ICS 23.020.30 CCS J 74 34 安徽省地方标准 DB34/T 4531 —2023 安徽省气瓶质量安全追溯信息平台 数据接口规范 Data interface specification for gas cy linder information quality tracing platform 2023 - 07 - 31 发布 2023 - 08 - 31 实施 安徽省市场监督管理局 发布 DB34/T 4531 —2023 I 目次 前言 ............................................................ ..................... II 1 范围 ......................................................... ...................... 1 2 规范性引 用文件 .................................................... ................. 1 3 术语和定义 ...................................................... ................... 1 4 缩略语 ........................................................ ..................... 1 5 数据交换 架构 ..................................................... .................. 1 6 接口基本 要求 ..................................................... .................. 2 接口协议类型 ....................................................... ............ 2 6.1 接口交换格式 ....................................................... ............ 2 6.2 接口数据类型 ....................................................... ............ 2 6.3 接口消息格式 ....................................................... ............ 3 6.4 附录 A（规范性） 接口规范的数据清单 ................................................... 4 A.1 市级气 瓶追溯平台从省级气瓶追溯平台下载数据的接口 ............................... 4 A.2 市级气 瓶追溯平台从省级气瓶追溯平台上传数据的接口 ............................... 9 DB34/T 4531 —2023 II 前言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由安徽省特种设备检测院提出。 本文件由安徽省市场监督管理局归口。 本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。 本文件主要起草人：莫诚生、赵龙、王仁涛、王彬彬、严伟、许佳伟、汪源、王启龙、熊钰才、程 嘉良、张伟。 DB34/T 4531 —2023 1 安徽省气瓶质量安全追溯信息平台数据接口规范 1 范围 本文件规定了气瓶质量安全追溯信息平台的数据交换架构、接口基本规定、接口 协议清单及内容。 本文件适用于省气瓶信息质量追溯平台（以下简称“省气瓶追溯平台”）与各市级气瓶信息质量追 溯平台（以下简称“市级气瓶追溯平台”）之间的数据交换。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 本文件没有需要界定的术语和定义。 4 缩略语 下列缩略语适用于本文件。 JSON：JavaScript对象简谱（JavaScript Object Notation）。 HTTP：超文本传输协议（Hyper Text T ransfer Protocol）。 HTTPS：超文本传输安全协议（Hyper Text Transfer Pro tocol over Se cure Socket Layer）。 5 数据交换架构 各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传， 省气瓶追溯平台负责统一 开发数据接口并进行维护更新，同时将数据同步到省大数据中心，以完成各平台间数据的互联互通。数据交换架构图见图1。 DB34/T 4531 —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/T 4531 —2023 3 接口消息格式 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的规定执行。 DB34/T 4531 —2023 4 A A 附录A （规范性） 接口规范的数据清单 A.1 市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口 A.1.1 市级平台身份认证接口 A.1.1.1 接口方法及说明 接口标识符：GetKey 接口说明：本接口用于市级平台获取身份认证密钥。 A.1.1.2 接口输入参数及说明 市级平台身份认证接口的输入参数及说明见表A.1。 表A.1 市级平台身份认证接口输入参数及说明 参数名 类型 非空 参数描述 appCode String 是 接入平台ID authCode String 是 接入方密钥 A.1.1.3 接口返回参数及说明 市级平台身份认证接口返回参数及说明见表A.2。 表A.2 市级平台身份认证接口返回参数及说明 参数名 类型 非空 参数描述 Data Key String 是 身份认证密钥，调用业务接口时使用 Expire String 是 密钥过期时间（单位：秒） Rt Status String 是 响应状态码 Msg String 是 响应状态描述 FromSystem String 是 源系统名称 A.1.2 气瓶使用登记信息接口（车用气瓶除外） A.1.2.1 接口方法及说明 接口标识符：Register_C ylinder 接口说明：本接口用于查询气瓶的使用登记信息。 A.1.2.2 接口输入参数及说明 气瓶使用登记信息