DB34 T 4531-2023 安徽省气瓶质量安全追溯信息平台数据接口规范.pdf
《DB34 T 4531-2023 安徽省气瓶质量安全追溯信息平台数据接口规范.pdf》由会员分享,可在线阅读,更多相关《DB34 T 4531-2023 安徽省气瓶质量安全追溯信息平台数据接口规范.pdf(22页珍藏版)》请在麦多课文档分享上搜索。
1、 ICS 23.020.30 CCS J 74 34 安徽省地方标准 DB34/T 45312023 安徽省气瓶质量安全追溯信息平台 数据接口规范 Data interface specification for gas cylinder information quality tracing platform 2023-07-31 发布 2023-08-31 实施安徽省市场监督管理局 发 布DB34/T 45312023 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 数据交换架构.1 6 接口基本要求.2 接口协议类型.2 6.1 接口交
2、换格式.2 6.2 接口数据类型.2 6.3 接口消息格式.3 6.4 附录 A(规范性)接口规范的数据清单.4 A.1 市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口.4 A.2 市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口.9 DB34/T 45312023 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省特种设备检测院提出。本文件由安徽省市场监督管理局归口。本文件起草单位:安徽省特种设备检测院、科大国创云网科技有限公司。本文件主要起草
3、人:莫诚生、赵龙、王仁涛、王彬彬、严伟、许佳伟、汪源、王启龙、熊钰才、程嘉良、张伟。DB34/T 45312023 1 安徽省气瓶质量安全追溯信息平台数据接口规范 1 范围 本文件规定了气瓶质量安全追溯信息平台的数据交换架构、接口基本规定、接口协议清单及内容。本文件适用于省气瓶信息质量追溯平台(以下简称“省气瓶追溯平台”)与各市级气瓶信息质量追溯平台(以下简称“市级气瓶追溯平台”)之间的数据交换。2 规范性引用文件 本文件没有规范性引用文件。3 术语和定义 本文件没有需要界定的术语和定义。4 缩略语 下列缩略语适用于本文件。JSON:JavaScript对象简谱(JavaScript Obje
4、ct Notation)。HTTP:超文本传输协议(Hyper Text Transfer Protocol)。HTTPS:超文本传输安全协议(Hyper Text Transfer Protocol over Secure Socket Layer)。5 数据交换架构 各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传,省气瓶追溯平台负责统一开发数据接口并进行维护更新,同时将数据同步到省大数据中心,以完成各平台间数据的互联互通。数据交换架构图见图1。DB34/T 45312023 2 图1 数据交换架构图 6 接口基本要求 接口协议类型 6.1 数据接口协议可采用HTTP或HTT
5、PS协议,接口请求方式为POST请求,采用同步方式进行。接口交换格式 6.2 接口交换格式采用JSON传输数据,具备通用性和可扩展性。接口数据类型 6.3 接口数据类型包括:字符串型(String);整数型(Int);小数型(Double);时间型(Date)。注:对“时间”类信息,以“1970年1月1日,00:00:00(GTM时间)”作为基准起始时间。DB34/T 45312023 3 接口消息格式 6.4 6.4.1 请求消息格式 消息格式:由请求头和请求参数组成。请求头:不同接口具有统一请求头,请求头的名称及其含义描述应符合表1的规定。请求参数:请求参数格式见表2列表形式,根据不同接口
6、功能,其请求参数不同。表1 接口请求头格式 名称 描述 必选/可选 Host 指定请求的服务器的域名和端口号 必选 Connection 表示是否需要持久链接 必选 Accept 标识接受所接收的内容类型 必选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Lentgh 请求的内容长度 必选 Cookie 请求发送时,会把保存在该请求域名下的所有cookie值一起发送给网站服务器 可选 User-Agent 内容包含发出请求的用户信息 可选 Token 访问连接的秘钥信息 可选 表2 接口请求参数格式 参数名 类型 非空 参数描述 给出该字段所代表的的参数名
7、用于描述数据的数据类型描述该参数是否可以为空对参数的描述及补充说明 6.4.2 响应消息格式 消息格式:由响应头和响应参数组成。响应头:不同接口具有统一响应头,响应头的名称及其含义描述应符合表3的规定。响应参数:响应参数格式见表4列表形式,根据不同接口功能,其响应参数不同。表3 接口响应头格式 名称 描述 必选/可选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Lentgh 请求的内容长度 必选 Date 服务器消息发出的时间 可选 Server 服务器软件名称 可选 表4 接口响应参数格式 参数名 类型 非空 参数描述 给出该字段所代表的的参数名 用于描述
8、数据的数据类型描述该参数是否可以为空对参数的描述及补充说明 6.4.3 接口协议内容 关于接口规范的数据清单按照附录A的规定执行。DB34/T 45312023 4 A A 附录A (规范性)接口规范的数据清单 A.1 市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口 A.1.1 市级平台身份认证接口 A.1.1.1 接口方法及说明 接口标识符:GetKey 接口说明:本接口用于市级平台获取身份认证密钥。A.1.1.2 接口输入参数及说明 市级平台身份认证接口的输入参数及说明见表A.1。表A.1 市级平台身份认证接口输入参数及说明 参数名 类型 非空 参数描述 appCode String 是
9、 接入平台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_
10、Cylinder 接口说明:本接口用于查询气瓶的使用登记信息。A.1.2.2 接口输入参数及说明 气瓶使用登记信息接口的输入参数及说明见表A.3。DB34/T 45312023 5 表A.3 气瓶使用登记信息接口输入参数及说明 参数名 类型 非空 参数描述 Key String 是 身份密钥 CertNo String 否 使用登记证编号 ProNo String 否 气瓶编号 Page Int 否 页数(默认为1)Rows Int 否 每页显示数(默认为10)A.1.2.3 接口返回参数及说明 气瓶使用登记信息返回参数及说明见表A.4。表A.4 气瓶使用登记信息接口返回参数及说明 返回参数
11、类型 非空 字段描述 Data UnitName String 是 产权单位名称 ContactStaff String 是 产权单位联系人 ContactNumber String 是 产权单位联系电话 IsImport String 是 是否进口(0-是,1-否)EquVariety String 是 设备品种(t1-无缝气瓶,t2焊接气瓶,t3-内装填料气瓶,t4-纤维缠绕气瓶,t5-低温绝热气瓶)ProNo String 是 气瓶编号 ProduceUnit String 是 制造单位名称或代号 ProduceDate Date 是 制造日期(yyyy-mm)FillingMedium
12、 String 是 充装介质(JZ01-氨气,JZ02-丙烷,JZ03-丙烯,JZ04-氮气,JZ05-丁烷,JZ06-二氧化硫,JZ07-二氧化碳,JZ08-氢气,JZ09-溶解乙炔,JZ10-氩气,JZ11-氧气,JZ12-液氨,JZ13-液二氧化碳,JZ14-液氯,JZ15-液氩,JZ16-液氧,JZ17液氮,JZ18-LNG,JZ19-CNG,JZ20-混合气,JZ21-液化石油气,JZ22-其他)NominalWorkingPressure Double 是 公称工作压力(单位:MPa)Volumn Double 是 公称容积(单位:L)DesignWallThickness Str
13、ing 是 设计壁厚(单位:mm)LastCheckUnit String 是 最近检验机构 LastCheckDate Date 是 最近检验日期(yyyy-mm)NextCheckDate Date 是 下次检验日期(yyyy-mm)RegisUnit String 否 登记机关(发证机关)RegisUser String 否 登记人员(发证人员)UseStat String 是 变更或停用情况(s1-在用,s2-停用,s3-注销,s4-报废)TagType String 是 标签类型(t1-二维码标签,t2-电子标签,t3-智能角阀,t4-其他,t5-无)TagNo String 是 标
14、签编号 CertNo String 是 使用登记证编号 DB34/T 45312023 6 表 A.4(续)返回参数 类型 非空 字段描述 Data CreateTime Date 是 录入时间(yyyy-MM-dd HH:mm:ss)UpDateTime Date 是 更新时间(yyyy-MM-dd HH:mm:ss)A.1.3 车用气瓶使用登记信息接口 A.1.3.1 接口方法及说明 接口标识符:CyRegister_Cylinder 接口说明:本接口用于查询车用气瓶使用登记信息。A.1.3.2 接口输入参数及说明 车用气瓶使用登记气瓶信息接口的输入参数及说明见表A.5。表A.5 车用气瓶
15、使用登记信息接口输入参数及说明 参数名 类型 非空 参数描述 Key String 是 身份密钥 CertNo String 否 使用登记证编号 CarNumber String 否 车牌号 ProNo String 否 气瓶编号 Page Int 否 页数(默认为1)Rows Int 否 每页显示数(默认为10)A.1.3.3 接口返回参数及说明 车用气瓶使用登记信息返回参数及说明见表A.6。表A.6 车用气瓶使用登记信息接口返回参数及说明 返回参数 类型 非空 字段描述 Data CylinderId String 是 系统内主键Id CarNumber String 是 车牌号 CarV
16、inNumber String 是 车辆VIN码 CarProduceUnit String 否 车辆制造单位 UseUnit String 是 使用单位名称 UseUnitContactStaff String 是 使用单位联系人 UseUnitContactTel String 是 使用单位联系电话 ProNo String 是 气瓶编号 EquVariety String 是 设备品种(t1-无缝气瓶,t2焊接气瓶,t3-内装填料气瓶,t4-纤维缠绕气瓶,t5-低温绝热气瓶)DB34/T 45312023 7 表 A.6(续)返回参数 类型 非空 字段描述 Data FillingMed
17、ium String 是 充装介质(JZ01-氨气,JZ02-丙烷,JZ03-丙烯,JZ04-氮气,JZ05-丁烷,JZ06-二氧化硫,JZ07-二氧化碳,JZ08-氢气,JZ09-溶解乙炔,JZ10-氩气,JZ11-氧气,JZ12-液氨,JZ13-液二氧化碳,JZ14-液氯,JZ15-液氩,JZ16-液氧,JZ17液氮,JZ18-LNG,JZ19-CNG,JZ20-混合气,JZ21-液化石油气,JZ22-其他)NominalWorkingPressure String 是 公称工作压力(单位:MPa)Volume String 是 公称容积(单位:L)ProduceDate Date 是 制
18、造日期(yyyy-mm)ProduceUnit String 是 制造单位名称或代号 ProduceUnitNo String 是 制造单位许可证 LastCheckUnit String 是 最近定期检验机构 LastCheckDate Date 是 最近定期检验日期(yyyy-mm)NextCheckDate Date 是 下次定期检验日期(yyyy-mm)RegisUnit String 否 登记机关(发证机关)RegisUser String 否 登记人员(发证人员)TagNo String 否 标签编号 TagType String 否 标签类型(t1-二维码标签,t2-电子标签,t
19、3-智能角阀,t4-其他,t5-无)CertNo String 是 使用登记证编号 CreateTime Date 是 录入时间(yyyy-MM-dd HH:mm:ss)UpDateTime Date 是 更新时间(yyyy-MM-dd HH:mm:ss)A.1.4 单位主体信息接口 A.1.4.1 接口方法及说明 接口标识符:OrgInfo 接口说明:本接口用于获取气瓶设计单位、制造单位、充装单位和检验单位信息。A.1.4.2 接口输入参数及说明 单位主体信息接口的输入参数及说明见表A.7。DB34/T 45312023 8 表A.7 单位主体接口输入参数及说明 参数名 类型 非空 参数描述
20、 Key String 是 身份密钥 UnitNature String 是 单位类型(c1:气瓶充装单位;c2:车用气瓶充装单位;c3:工业气瓶充装单位:j4:气瓶检验单位:j5:车用气瓶检验单位;j6:工业气瓶检验单位;z7气瓶制造单位)UnitName String 是 单位名称 UnitCode String 否 单位统一社会信用代码 Page Int 否 页数(默认为1)Rows Int 否 每页显示数(默认为10)A.1.4.3 接口返回参数及说明 单位主体信息返回参数及说明见表A.8。表A.8 单位主体信息接口返回参数及说明 返回参数 类型 非空 字段描述 Data UnitId
21、 String 是 系统内主键Id UnitOrgCode String 是 单位机构序列编码 UnitOrgIdSeq String 是 单位机构序列id UnitName String 是 单位名称 UnitSimpleName String 是 单位简称 PropertyUnitSocialCode String 是 统一社会信用代码 UnitPhone String 是 单位联系电话 UnitLegalStaff String 是 法定代表人 UnitLegalPhone String 是 联系人联系电话 UnitContactStaff String 是 单位联系人 CertNo S
22、tring 是 单位许可证号 UnitLocation String 是 单位地址 LangLat String 是 单位地址经纬度字符串,采用BD09坐标系,格式为经度,维度 Longitude Double 是 单位地址经度(BD09坐标系)Latitude Double 是 单位地址维度(BD09坐标系)UnitStatus String 是 单位状态(0-正常,1-停业,2-注销)UnitNature String 是 单位类型(c1:气瓶充装单位;c2:车用气瓶充装单位;c3:工业气瓶充装单位:j4:气瓶检验单位:j5:车用气瓶检验单位;j6:工业气瓶检验单位;z7气瓶制造单位)Cr
23、eateTime Date 是 录入时间(yyyy-MM-dd HH:mm:ss)UpDateTime Date 是 更新时间(yyyy-MM-dd HH:mm:ss)A.1.5 充装作业人员信息接口 DB34/T 45312023 9 A.1.5.1 接口方法及说明 接口标识符:FillingStaff 接口说明:本接口用于查询气瓶充装作业人员的信息。A.1.5.2 接口输入参数及说明 气瓶充装作业人员信息接口的输入参数及说明见表A.9。表A.9 气瓶充装作业人员信息接口输入参数及说明 参数名 类型 非空 参数描述 Key String 是 身份密钥 StaffIdCard String 否
24、 作业人员身份证号 StaffName String 否 作业人员姓名 UnitName String 否 所属单位名称 UnitSocialCode String 否 所属单位统一社会信用代码 Page Int 否 页数(默认为1)Rows Int 否 每页显示数(默认为10)A.1.5.3 接口返回参数及说明 气瓶充装作业人员信息接口返回参数及说明见表A.10。表A.10 表气瓶充装作业人员信息接口返回参数及说明 返回参数 类型 非空 字段描述 Data StaffId String 是 系统内主键Id StaffName String 是 作业人员姓名 StaffIdCard Strin
25、g 是 作业人员身份证号 Age String 是 年龄 Gender String 是 性别(0-女,1-男)Phone String 否 联系方式 UnitName Double 否 所属单位名称 UnitSocialCode Double 否 所属单位统一社会信用代码 CertificateNo String 否 作业证书编号 CertificateGetDate Date 否 作业证书获取时间(yyyy-mm-dd)CertificateEffectiveDate Date 是 作业证书到期时间(yyyy-mm-dd)CreateTime Date 是 录入时间(yyyy-MM-dd
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB34 4531-2023 安徽省气瓶质量安全追溯信息平台数据接口规范 4531 2023 安徽省 质量 安全 追溯 信息 平台 数据 接口 规范
