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

ICS点击此处添加ICS号 点击此处添加中国标准文献分类号 DB34 安徽省地方标准 DB 34/ XXXXX—XXXX 安徽省气瓶质量安全追溯信息平台数据接口规范 Data Interface Specification for Gas Cylinder Safety Traceability of Anhui 点击此处添加与国际标准一致性程度的标识 XXXX - XX - XX发布 XXXX - XX - XX实施 安徽省市场监督管理局 发布 前 言 本标准依据GB/T 1.1-2020给出的规则起草。 本标准由安徽省特种设备检测院提出。 本标准由安徽省市场监督管理局归口。 本标准起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。 本标准主要起草人：王恩和、冯强中、莫诚生、吴春、李军、许佳伟。 安徽省气瓶质量安全追溯信息平台数据接口规范 1 范围 本标准规定了安徽省气瓶质量安全追溯信息平台的数据交换架构、数据交换环境、数据交换模式、接口总则、接口响应状态编码、接口协议约定及协议清单、接口协议的内容，适用于省、市及气瓶充装单位、检验单位之间关于气瓶质量安全追溯要求的数据交换，同时适用于安徽省气瓶质量安全追溯信息平台的建设单位、研发单位的系统开发、平台对接、接口测试、系统验收工作。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法 GB/T 13005-2011 气瓶术语 GB/T 36373.1-2018 特种设备信息资源管理 数据元规范 第1部分：气瓶 TSG 08-2017 特种设备使用管理规则 TSG 23-2021 气瓶安全技术规程 TSG 07-2019 特种设备生产和充装单位许可规则 TSG Z6001-2019 特种设备作业人员考核规则 3 术语和定义 下列术语和定义适用于本文件。 设备品种：按照TSG 23-2021和特种设备目录规定，气瓶品种分为无缝气瓶、焊接气瓶、特种气瓶（内装燃料气瓶、纤维缠绕气瓶、低温绝热气瓶） 气瓶类型：本标准中定义气瓶类型按照使用用途及业务范围进行分类，包括液化石油气瓶、车用气瓶和工业用气瓶，不包括医用气瓶、呼吸器用气瓶和消防灭火用气瓶 HTTP：是指超文本传输协议是一个简单的请求-响应协议，它指定了客户端发送给服务器的消息以及响应内容，是一种通用的应用数据传输协议。 4 数据交换架构 省、市、气瓶充装或检验单位的气瓶质量安全追溯信息平台可通过三级数据交换架构形式进行，省级平台为省级部门提供数据服务支撑，与各市级平台互联互通；市级平台为市级部门提供数据服务支撑，与各充装单位或检验站单位互联互通；省级平台也可直接与各充装单位或检验站单位互联互通。 数据交换架构如图1所示： 图1 数据交换架构体系图 省级平台建立数据交换节点或通过前置机部署数据库，开通市级、充装单位和检验单位接口调用权限或数据库访问权限，完成各自平台数据的双向交换； 市级平台建立数据交换节点或通过前置机部署数据库，开通充装单位和检验单位的平台接口调用权限或数据库访问权限，完成各自平台数据的双向交换； 5 数据交换环境要求 安徽省气瓶质量安全追溯信息平台数据交换应优先依托于政务外网进行，省、市、充装单位/检验单位三级平台应当优先利用电子政务外网开放必须的通信端口，整个数据交换体系架构支持互联网接口请求与调用。 5.1 网络环境应满足如下要求 a) 宜采用电子政务外网或满足要求的互联网； b) 网络带宽不宜低于50Mbps； c) 网络环境需长期稳定； 5.2 交换节点应满足如下要求 d) 宜采用专用设备； e) 性能要求，CPU 4核、内存 8G； f) 交换节点需安全可靠。 6 数据交换模式 6.1 基于HTTP协议的接口调用 6.1.1 该调用方式适用于获取实时性、小数据包、结构化、非结构化、半结构化的数据，以及具备接口调用存储能力的系统。接口调用流程应符合图2的要求，详细的接口清单及约定内容见《附录A 气瓶质量安全追溯信息平台HTTP接口协议要求》 图2 接口调用流程图 图中的服务方表示提供接口服务的一方；调用方表示需要进行接口调用的一方； 调用方在调用接口前需向服务方申请调用权限，可预先提供调用方的相关信息，以获取服务方提供的用户识别码，调用方再根据用户识别码鉴权获取接口服务的授权码，从而进行接口的访问调用，返回的接口响应状态编码详情见第9章。 6.2 基于数据抽取服务的数据交换 6.2.1 数据抽取服务的交换方式一般用于数据量大、实时性要求不高、不具备HTTP接口调用能力或局域网部署的周期性、结构化的数据场景。数据库抽取的流程应符合图3的要求： 图3 数据抽取示意图 数据提供方按照预先制定的标准数据结构写入数据，与数据接收方约定数据抽取规则并提供数据库访问权限，数据接收方按照约定内容进行数据抽取并回执数据获取状态。对接的数据内容见《附录B 安徽省气瓶质量安全追溯信息平台数据交换内容》 7 数据集成要求 7.1 数据交换对接要求 a) 对接时，接口服务方及调用方应积极配合完成软硬件的安装部署和网络联通工作，以及做相应的调试、验证工作； b) 联调并测试通过后，切换正式环境，各市和充装站/检验站系统开始正式上传或读取下载数据。 7.2 接口维护及巡检要求 各接口服务方及调用方均应建立完善的巡检和维护管理制度，服务方如接口需调整，应当至少提前2个工作日通知接口调用方，告知接口调整情况。为保障接口和前置库程序能正常使用，安徽省气瓶质量安全追溯信息平台应提供定期巡检制度以供参考，详情如下： 分类 巡检项 建议处理措施 硬件 设备停机、死机 联系接口服务方查看故障原因，重启设备 CPU、内存、硬盘空间不足 联系接口服务方查看硬件使用情况，合理扩容 接口 网络不通 核实网络、端口访问是否正确有效 接口报错 联系接口服务方查看报错日志并处理 接口运行缓慢 联系接口服务方查看解接口运行日志并处理 接口数据丢失或内容错误 联系接口服务方核实数据来源和是否存在积压情况 操作系统 病毒入侵 联系接口服务方查看病毒问题并解决 7.3 前置库数据处理及同步要求 考虑服务器资源，前置库多用于待交换数据临时存放，省、市级应对本级交换节点上的前置库数据进行定期删除，原则上要求数据仅存1个月，且定期进行全量数据的同步工作。 8 接口基本要求 8.1 同步异步接口使用原则 采用同步方式进行接口交互。 8.2 接口异常响应提示信息原则 8.2.1 接口异常响应提示信息应符合以下原则： a) 接口异常响应中，能够明确的错误信息一定要表述清楚，并把详细报错信息记录到日志。 b)