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

ICS?23.020.30 CCS?J?74 34 安 徽 省 地 方 标 准 DB34/T?4531—2023 安徽省气瓶质量安全追溯信息平台 数据接口规范 Data?interface?specification?for?gas?cylinder?information?quality?tracing?platform 2023?-?07?-?31?发布 2023?-?08?-?31?实施 安徽省市场监督管理局 发?布 DB34/T?4531—2023 目 次 前言?? II 1??范围?? 1 2??规范性引用文件?? 1 3??术语和定义?? 1 4??缩略语?? 1 5??数据交换架构?? 1 6??接口基本要求?? 2 6.1 接口协议类型  ?2 6.2 6.3 6.4 接口交换格式? ?2 接口数据类型? ?2 接口消息格式? ?3 附录?A（规范性）??接口规范的数据清单?? 4 A.1??市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口?? 4 A.2??市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口?? 9 I DB34/T?4531—2023 前 言 本文件按照GB/T?1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由安徽省特种设备检测院提出。 本文件由安徽省市场监督管理局归口。 本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。 本文件主要起草人：莫诚生、赵龙、王仁涛、王彬彬、严伟、许佳伟、汪源、王启龙、熊钰才、程 嘉良、张伟。 II DB34/T?4531—2023 安徽省气瓶质量安全追溯信息平台数据接口规范 1??范围 本文件规定了气瓶质量安全追溯信息平台的数据交换架构、接口基本规定、接口协议清单及内容。 本文件适用于省气瓶信息质量追溯平台（以下简称“省气瓶追溯平台”）与各市级气瓶信息质量追 溯平台（以下简称“市级气瓶追溯平台”）之间的数据交换。 2??规范性引用文件 本文件没有规范性引用文件。 3??术语和定义 本文件没有需要界定的术语和定义。 4??缩略语 下列缩略语适用于本文件。 JSON：JavaScript对象简谱（JavaScript?Object?Notation）。 HTTP：超文本传输协议（Hyper?Text?Transfer?Protocol）。 HTTPS：超文本传输安全协议（Hyper?Text?Transfer?Protocol?over?Secure?Socket?Layer）。 5??数据交换架构 各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传，省气瓶追溯平台负责统一 开发数据接口并进行维护更新，同时将数据同步到省大数据中心，以完成各平台间数据的互联互通。数 据交换架构图见图1。 1 DB34/T?4531—2023 图1??数据交换架构图 6??接口基本要求 6.1 6.2 6.3 2 接口协议类型 数据接口协议可采用HTTP或HTTPS协议,接口请求方式为POST请求，采用同步方式进行。 接口交换格式 接口交换格式采用JSON传输数据，具备通用性和可扩展性。 接口数据类型 接口数据类型包括： ——字符串型（String）； ——整数型（Int）； ——小数型（Double）； ——时间型（Date）。 注：对“时间”类信息，以“1970年1月1日，00:00:00（GTM时间）”作为基准起始时间。 名称 描述 必选/可选 Host 指定请求的服务器的域名和端口号 必选 Connection 表示是否需要持久链接 必选 Accept 标识接受所接收的内容类型 必选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Lentgh 请求的内容长度 必选 Cookie 请求发送时，会把保存在该请求域名下的所有cookie值一起发送给网站服务器 可选 User-Agent 内容包含发出请求的用户信息 可选 Token 访问连接的秘钥信息 可选 名称 描述 必选/可选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Lentgh 请求的内容长度 必选 Date 服务器消息发出的时间 可选 Server 服务器软件名称 可选 参数名 类型 非空 参数描述 给出该字段所代表的的参数名 用于描述数据的数据类型 描述该参数是否可以为空 对参数的描述及补充说明 — — — — 参数名 类型 非空 参数描述 给出该字段所代表的的参数名 用于描述数据的数据类型 描述该参数是否可以为空 对参数的描述及补充说明 — — — — DB34/T?4531—2023 6.4