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

《DB34_T 4531-2023 安徽省气瓶质量安全追溯信息平台数据接口规范.docx》由会员分享，可在线阅读，更多相关《DB34_T 4531-2023 安徽省气瓶质量安全追溯信息平台数据接口规范.docx（21页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS23.020.30CCSJ7434安徽省地方标准DB34/T45312023安徽省气瓶质量安全追溯信息平台数据接口规范Datainterfacespecificationforgascylinderinformationqualitytracingplatform2023-07-31发布2023-08-31实施安徽省市场监督管理局发布DB34/T45312023目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15数据交换架构.16接口基本要求.26.1接口协议类型.26.26.36.4接口交换格式.2接口数据类型.2接口消息格式.3附录A（规范性）接口规范的数据清单

2、.4A.1市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口.4A.2市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口.9IDB34/T45312023前言本文件按照GB/T1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省特种设备检测院提出。本文件由安徽省市场监督管理局归口。本文件起草单位：安徽省特种设备检测院、科大国创云网科技有限公司。本文件主要起草人：莫诚生、赵龙、王仁涛、王彬彬、严伟、许佳伟、汪源、王启龙、熊钰才、程嘉良、张伟。IIDB34/T45312023安徽省气瓶质量安

3、全追溯信息平台数据接口规范1范围本文件规定了气瓶质量安全追溯信息平台的数据交换架构、接口基本规定、接口协议清单及内容。本文件适用于省气瓶信息质量追溯平台（以下简称“省气瓶追溯平台”）与各市级气瓶信息质量追溯平台（以下简称“市级气瓶追溯平台”）之间的数据交换。2规范性引用文件本文件没有规范性引用文件。3术语和定义本文件没有需要界定的术语和定义。4缩略语下列缩略语适用于本文件。JSON：JavaScript对象简谱（JavaScriptObjectNotation）。HTTP：超文本传输协议（HyperTextTransferProtocol）。HTTPS：超文本传输安全协议（HyperTextT

4、ransferProtocoloverSecureSocketLayer）。5数据交换架构各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传，省气瓶追溯平台负责统一开发数据接口并进行维护更新，同时将数据同步到省大数据中心，以完成各平台间数据的互联互通。数据交换架构图见图1。1DB34/T45312023图1数据交换架构图6接口基本要求6.16.26.32接口协议类型数据接口协议可采用HTTP或HTTPS协议,接口请求方式为POST请求，采用同步方式进行。接口交换格式接口交换格式采用JSON传输数据，具备通用性和可扩展性。接口数据类型接口数据类型包括：字符串型（String）；整数型

5、（Int）；小数型（Double）；时间型（Date）。注：对“时间”类信息，以“1970年1月1日，00:00:00（GTM时间）”作为基准起始时间。名称描述必选/可选Host指定请求的服务器的域名和端口号必选Connection表示是否需要持久链接必选Accept标识接受所接收的内容类型必选Content-Type请求的与实体对应的MIME信息必选Content-Lentgh请求的内容长度必选Cookie请求发送时，会把保存在该请求域名下的所有cookie值一起发送给网站服务器可选User-Agent内容包含发出请求的用户信息可选Token访问连接的秘钥信息可选名称描述必选/可选Conte

6、nt-Type请求的与实体对应的MIME信息必选Content-Lentgh请求的内容长度必选Date服务器消息发出的时间可选Server服务器软件名称可选参数名类型非空参数描述给出该字段所代表的的参数名用于描述数据的数据类型描述该参数是否可以为空对参数的描述及补充说明参数名类型非空参数描述给出该字段所代表的的参数名用于描述数据的数据类型描述该参数是否可以为空对参数的描述及补充说明DB34/T453120236.4接口消息格式6.4.1请求消息格式消息格式：由请求头和请求参数组成。请求头：不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。请求参数：请求参数格式见表2列表形式，根

7、据不同接口功能，其请求参数不同。表1接口请求头格式表2接口请求参数格式6.4.2响应消息格式消息格式：由响应头和响应参数组成。响应头：不同接口具有统一响应头，响应头的名称及其含义描述应符合表3的规定。响应参数：响应参数格式见表4列表形式，根据不同接口功能，其响应参数不同。表3接口响应头格式表4接口响应参数格式6.4.3接口协议内容关于接口规范的数据清单按照附录A的规定执行。3参数名类型非空参数描述DataKeyString是身份认证密钥，调用业务接口时使用ExpireString是密钥过期时间（单位：秒）RtStatusString是响应状态码MsgString是响应状态描述FromSyste

8、mString是源系统名称参数名类型非空参数描述appCodeString是接入平台IDauthCodeString是接入方密钥DB34/T45312023AA附录A（规范性）接口规范的数据清单A.1市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口A.1.1市级平台身份认证接口A.1.1.1接口方法及说明接口标识符：GetKey接口说明：本接口用于市级平台获取身份认证密钥。A.1.1.2接口输入参数及说明市级平台身份认证接口的输入参数及说明见表A.1。表A.1市级平台身份认证接口输入参数及说明A.1.1.3接口返回参数及说明市级平台身份认证接口返回参数及说明见表A.2。表A.2市级平台身份认证

9、接口返回参数及说明A.1.2气瓶使用登记信息接口（车用气瓶除外）A.1.2.1接口方法及说明接口标识符：Register_Cylinder接口说明：本接口用于查询气瓶的使用登记信息。A.1.2.2接口输入参数及说明气瓶使用登记信息接口的输入参数及说明见表A.3。4返回参数类型非空字段描述DataUnitNameString是产权单位名称ContactStaffString是产权单位联系人ContactNumberString是产权单位联系电话IsImportString是是否进口（0-是,1-否）EquVarietyString是设备品种（t1-无缝气瓶，t2焊接气瓶，t3-内装填料气瓶，t4

10、-纤维缠绕气瓶，t5-低温绝热气瓶）ProNoString是气瓶编号ProduceUnitString是制造单位名称或代号ProduceDateDate是制造日期（yyyy-mm）FillingMediumString是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液氧，JZ17液氮，JZ18-LNG，JZ19-CNG，JZ20-混合气，JZ21-液化石油气，JZ2

11、2-其他）NominalWorkingPressureDouble是公称工作压力（单位:MPa）VolumnDouble是公称容积（单位:L）DesignWallThicknessString是设计壁厚（单位:mm）LastCheckUnitString是最近检验机构LastCheckDateDate是最近检验日期(yyyy-mm)NextCheckDateDate是下次检验日期(yyyy-mm)RegisUnitString否登记机关（发证机关）RegisUserString否登记人员（发证人员）UseStatString是变更或停用情况（s1-在用,s2-停用,s3-注销,s4-报废）Ta

12、gTypeString是标签类型（t1-二维码标签,t2-电子标签,t3-智能角阀,t4-其他,t5-无）TagNoString是标签编号CertNoString是使用登记证编号参数名类型非空参数描述KeyString是身份密钥CertNoString否使用登记证编号ProNoString否气瓶编号PageInt否页数（默认为1）RowsInt否每页显示数（默认为10）DB34/T45312023表A.3气瓶使用登记信息接口输入参数及说明A.1.2.3接口返回参数及说明气瓶使用登记信息返回参数及说明见表A.4。表A.4气瓶使用登记信息接口返回参数及说明5返回参数类型非空字段描述DataCyli

13、nderIdString是系统内主键IdCarNumberString是车牌号CarVinNumberString是车辆VIN码CarProduceUnitString否车辆制造单位UseUnitString是使用单位名称UseUnitContactStaffString是使用单位联系人UseUnitContactTelString是使用单位联系电话ProNoString是气瓶编号EquVarietyString是设备品种（t1-无缝气瓶，t2焊接气瓶，t3-内装填料气瓶，t4-纤维缠绕气瓶，t5-低温绝热气瓶）参数名类型非空参数描述KeyString是身份密钥CertNoString否使用登

14、记证编号CarNumberString否车牌号ProNoString否气瓶编号PageInt否页数（默认为1）RowsInt否每页显示数（默认为10）返回参数类型非空字段描述DataCreateTimeDate是录入时间(yyyy-MM-ddHH:mm:ss)UpDateTimeDate是更新时间(yyyy-MM-ddHH:mm:ss)DB34/T45312023表A.4（续）A.1.3车用气瓶使用登记信息接口A.1.3.1接口方法及说明接口标识符：CyRegister_Cylinder接口说明：本接口用于查询车用气瓶使用登记信息。A.1.3.2接口输入参数及说明车用气瓶使用登记气瓶信息接口的

15、输入参数及说明见表A.5。表A.5车用气瓶使用登记信息接口输入参数及说明A.1.3.3接口返回参数及说明车用气瓶使用登记信息返回参数及说明见表A.6。表A.6车用气瓶使用登记信息接口返回参数及说明6返回参数类型非空字段描述DataFillingMediumString是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液氧，JZ17液氮，JZ18-LNG，JZ19-CN

16、G，JZ20-混合气，JZ21-液化石油气，JZ22-其他）NominalWorkingPressureString是公称工作压力（单位:MPa）VolumeString是公称容积（单位:L）ProduceDateDate是制造日期(yyyy-mm)ProduceUnitString是制造单位名称或代号ProduceUnitNoString是制造单位许可证LastCheckUnitString是最近定期检验机构LastCheckDateDate是最近定期检验日期(yyyy-mm)NextCheckDateDate是下次定期检验日期(yyyy-mm)RegisUnitString否登记机关（发证

17、机关）RegisUserString否登记人员（发证人员）TagNoString否标签编号TagTypeString否标签类型（t1-二维码标签,t2-电子标签,t3-智能角阀,t4-其他,t5-无）CertNoString是使用登记证编号CreateTimeDate是录入时间(yyyy-MM-ddHH:mm:ss)UpDateTimeDate是更新时间(yyyy-MM-ddHH:mm:ss)DB34/T45312023表A.6（续）A.1.4单位主体信息接口A.1.4.1接口方法及说明接口标识符：OrgInfo接口说明：本接口用于获取气瓶设计单位、制造单位、充装单位和检验单位信息。A.1.4

18、.2接口输入参数及说明单位主体信息接口的输入参数及说明见表A.7。7返回参数类型非空字段描述DataUnitIdString是系统内主键IdUnitOrgCodeString是单位机构序列编码UnitOrgIdSeqString是单位机构序列idUnitNameString是单位名称UnitSimpleNameString是单位简称PropertyUnitSocialCodeString是统一社会信用代码UnitPhoneString是单位联系电话UnitLegalStaffString是法定代表人UnitLegalPhoneString是联系人联系电话UnitContactStaffStri

19、ng是单位联系人CertNoString是单位许可证号UnitLocationString是单位地址LangLatString是单位地址经纬度字符串，采用BD09坐标系，格式为经度,维度LongitudeDouble是单位地址经度(BD09坐标系)LatitudeDouble是单位地址维度(BD09坐标系)UnitStatusString是单位状态(0-正常，1-停业，2-注销)UnitNatureString是c3：工业气瓶充装单位：j4：气瓶检验单位：j5：车用气瓶检验单位；j6：工业气瓶检验单位；z7气瓶制造单位）CreateTimeDate是录入时间(yyyy-MM-ddHH:mm:s

20、s)UpDateTimeDate是更新时间(yyyy-MM-ddHH:mm:ss)参数名类型非空参数描述KeyString是身份密钥UnitNatureString是单位类型（c1：气瓶充装单位；c2：车用气瓶充装单位；c3：工业气瓶充装单位：j4：气瓶检验单位：j5：车用气瓶检验单位；j6：工业气瓶检验单位；z7气瓶制造单位）UnitNameString是单位名称UnitCodeString否单位统一社会信用代码PageInt否页数（默认为1）RowsInt否每页显示数（默认为10）DB34/T45312023表A.7单位主体接口输入参数及说明A.1.4.3接口返回参数及说明单位主体信息返回

21、参数及说明见表A.8。表A.8单位主体信息接口返回参数及说明单位类型（c1：气瓶充装单位；c2：车用气瓶充装单位；A.1.5充装作业人员信息接口8返回参数类型非空字段描述DataStaffIdString是系统内主键IdStaffNameString是作业人员姓名StaffIdCardString是作业人员身份证号AgeString是年龄GenderString是性别（0-女，1-男）PhoneString否联系方式UnitNameDouble否所属单位名称UnitSocialCodeDouble否所属单位统一社会信用代码CertificateNoString否作业证书编号Certificat

22、eGetDateDate否作业证书获取时间（yyyy-mm-dd）CertificateEffectiveDateDate是作业证书到期时间（yyyy-mm-dd）CreateTimeDate是录入时间(yyyy-MM-ddHH:mm:ss)参数名类型非空参数描述KeyString是身份密钥StaffIdCardString否作业人员身份证号StaffNameString否作业人员姓名UnitNameString否所属单位名称UnitSocialCodeString否所属单位统一社会信用代码PageInt否页数（默认为1）RowsInt否每页显示数（默认为10）DB34/T45312023A.

23、1.5.1接口方法及说明接口标识符：FillingStaff接口说明：本接口用于查询气瓶充装作业人员的信息。A.1.5.2接口输入参数及说明气瓶充装作业人员信息接口的输入参数及说明见表A.9。表A.9气瓶充装作业人员信息接口输入参数及说明A.1.5.3接口返回参数及说明气瓶充装作业人员信息接口返回参数及说明见表A.10。表A.10表气瓶充装作业人员信息接口返回参数及说明A.2市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口A.2.1气瓶相关数据接口（车用气瓶除外）A.2.1.1气瓶档案上传接口A.2.1.1.1接口方法及说明9返回参数类型非空字段描述KeyString是身份密钥DataCyli

24、nderIdString是系统内主键IdUnitNameString是产权单位名称PropertyUnitSocialCodeString是产权单位统一社会信用代码ContactStaffString是产权单位联系人ContactNumberString是产权单位联系电话IsOwnerString是是否自有产权（0-是,1-否）IsImportString是是否进口（0-是,1-否）EquVarietyString是t4-纤维缠绕气瓶，t5-低温绝热气瓶）ProNoString是气瓶编号ProduceUnitString是制造单位名称或代号ProduceUnitNoString是制造单位许可证

25、ProduceDateDate是制造日期（yyyy-mm）FillingMediumString是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液氧，JZ17液氮，JZ18-LNG，JZ19-CNG，JZ20-混合气，JZ21-液化石油气，JZ22-其他）NominalWorkingPressureDouble是公称工作压力（单位:MPa）VolumnDouble是

26、公称容积（单位:L）WeightDouble是气瓶净重（单位:kg）DesignWallThicknessString是设计壁厚（单位:mm）DesignWorkingLifeString是设计使用年限LastCheckUnitString是最新检验机构LastCheckDateDate是最近检验日期(yyyy-mm)NextCheckDateDate是下次检验日期(yyyy-mm)UseStatString是变更或停用情况（s1-在用,s2-停用,s3-注销,s4-报废）TagTypeString是标签类型（t1-二维码标签,t2-电子标签,t3-智能角阀,t4-其他,t5-无）TagNoS

27、tring是标签编号GroupIdInt否所属瓶组IDDB34/T45312023接口标识符：QpBaseInfo接口说明：该接口用于上传市级气瓶追溯平台的气瓶档案数据信息。A.2.1.1.2接口输入参数及说明气瓶档案接口的输入参数及说明见表A.11。表A.11气瓶档案接口输入参数及说明设备品种（t1-无缝气瓶，t2焊接气瓶，t3-内装填料气瓶，10返回参数类型非空字段描述KeyString是身份密钥DataGroupIdString是系统内主键IdGroupCodeString是瓶组编号TagNoString否标签编号TagTypeString是标签类型（t1-二维码标签,t2-电子标签,t

28、3-智能角阀,t4-其他,t5-无）FillingMediumString是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液氧，JZ17液氮，JZ18-LNG，JZ19-CNG，JZ20-混合气，JZ21-液化石油气，JZ22-其他）参数名类型非空参数描述DataInt是气瓶档案上传成功数量RtStatusString是上传状态码MsgString是上传状态描述Fr

29、omSystemString是源系统名称返回参数类型非空字段描述DataGroupCodeString否所属瓶组编码CertNoString是使用登记证编号CreateTimeDate是录入时间(yyyy-MM-ddHH:mm:ss)UpDateTimeDate是更新时间(yyyy-MM-ddHH:mm:ss)DB34/T45312023表A.11（续）A.2.1.1.3接口返回参数及说明气瓶档案信息上传后的返回参数及说明见表A.12。表A.12气瓶档案信息接口返回参数及说明A.2.1.2气瓶瓶组信息上传接口A.2.1.2.1接口方法及说明接口标识符：QpGroup接口说明：该接口用于上传市级

30、气瓶追溯平台的气瓶瓶组数据信息。A.2.1.2.2接口输入参数及说明工业气瓶瓶组接口的输入参数及说明见表A.13。表A.13气瓶瓶组信息接口输入参数及说明11返回参数类型非空字段描述KeyString是身份密钥DataUnitNameString是充装单位名称CylinderIdInt是气瓶档案主键idProNoString是气瓶编号ProduceUnitString是制造单位名称或代号ProduceUnitCodeString是制造单位许可证TagTypeString是标签类型（t1-二维码标签,t2-电子标签,t3-智能角阀,t4-其他,t5-无）TagNoString是标签编号参数名类型

31、非空参数描述DataInt是气瓶瓶组信息上传成功记录数RtStatusString是上传状态码MsgString是上传状态描述FromSystemString是源系统名称返回参数类型非空字段描述DataUnitNameString是产权单位名称PropertyUnitSocialCodeString是产权单位统一社会信用代码CreateTimeDate是录入时间(yyyy-MM-ddHH:mm:ss)UpDateTimeDate是更新时间(yyyy-MM-ddHH:mm:ss)DB34/T45312023表A.13（续）A.2.1.2.3接口返回参数及说明气瓶瓶组信息上传后的返回参数及说明见表

32、A.14。表A.14气瓶瓶组信息接口返回参数及说明A.2.1.3气瓶充装信息上传接口A.2.1.3.1接口方法及说明接口标识符：QpFillingCheckInfo接口说明：该接口用于上传气瓶的充装信息（包括充装记录和充装前、后检查记录）。A.2.1.3.2接口输入参数及说明气瓶充装信息接口的输入参数及说明见表A.15。表A.15气瓶充装信息接口输入参数及说明12返回参数类型非空字段描述DataFillingMediumString是充装介质（JZ01-氨气，JZ02-丙烷，JZ03-丙烯，JZ04-氮气，JZ05-丁烷，JZ06-二氧化硫，JZ07-二氧化碳，JZ08-氢气，JZ09-溶解乙

33、炔，JZ10-氩气，JZ11-氧气，JZ12-液氨，JZ13-液二氧化碳，JZ14-液氯，JZ15-液氩，JZ16-液氧，JZ17液氮，JZ18-LNG，JZ19-CNG，JZ20-混合气，JZ21-液化石油气，JZ22-其他）OverCheckDateInt是是否超期未检（0-是，1-否）OverDesignDateInt是是否超设计使用年限（0-是，1-否）ProduceLogoInt是生产标识是否清晰（0-是，1-否）ResidualPresureInt是瓶内有无余压(0-合格，1-不合格)CylinderAppearanceInt是外观是否无裂痕，腐蚀及其他损坏缺陷（0,-是，1-否）LeakageInt是是否泄露(0-未泄露，1-泄露）WarningLabelsInt是是否粘贴警示标签及产品合格标签(0-是，1-否)CylinderEnclosureInt是附件(瓶阀、瓶帽、防震圈）是否齐全且符合要求(0-是，1-否)CylinderCheckResult