![点击分享此内容可以赚币 分享](/master/images/share_but.png)
DB34T4531-2023安徽省气瓶质量安全追溯信息平台数据接口规范.docx
《DB34T4531-2023安徽省气瓶质量安全追溯信息平台数据接口规范.docx》由会员分享,可在线阅读,更多相关《DB34T4531-2023安徽省气瓶质量安全追溯信息平台数据接口规范.docx(22页珍藏版)》请在咨信网上搜索。
1、ICS 23.020.3034CCS J 74安徽省地方标准DB34/T 45312023安徽省气瓶质量安全追溯信息平台数据接口规范Data interface specification for gas cylinder information quality tracing platform2023 - 07 - 31 发布2023 - 08 - 31 实施安徽省市场监督管理局发 布DB34/T 45312023目次前言II1 范围12 规范性引用文件13 术语和定义14 缩略语15 数据交换架构16 接口基本要求26.1 接口协议类型26.2 接口交换格式26.3 接口数据类型26.4
2、接口消息格式3A.1 市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口4A.2 市级气瓶追溯平台从省级气瓶追溯平台上传数据的接口9I附录 A(规范性) 接口规范的数据清单4前言本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省特种设备检测院提出。本文件由安徽省市场监督管理局归口。本文件起草单位:安徽省特种设备检测院、科大国创云网科技有限公司。本文件主要起草人:莫诚生、赵龙、王仁涛、王彬彬、严伟、许佳伟、汪源、王启龙、熊钰才、程嘉良、张伟。II安徽省气瓶质量安全
3、追溯信息平台数据接口规范1 范围本文件规定了气瓶质量安全追溯信息平台的数据交换架构、接口基本规定、接口协议清单及内容。本文件适用于省气瓶信息质量追溯平台(以下简称“省气瓶追溯平台”)与各市级气瓶信息质量追溯平台(以下简称“市级气瓶追溯平台”)之间的数据交换。2 规范性引用文件本文件没有规范性引用文件。3 术语和定义本文件没有需要界定的术语和定义。4 缩略语JSON:JavaScript对象简谱(JavaScript Object Notation)。HTTP:超文本传输协议(Hyper Text Transfer Protocol)。HTTPS:超文本传输安全协议(Hyper Text Tra
4、nsfer Protocol over Secure Socket Layer)。5 数据交换架构各市级气瓶追溯平台按照数据接口规范要求实现业务数据的下载和上传,省气瓶追溯平台负责统一开发数据接口并进行维护更新,同时将数据同步到省大数据中心,以完成各平台间数据的互联互通。数据交换架构图见图1。1下列缩略语适用于本文件。图1 数据交换架构图6 接口基本要求6.1 接口协议类型数据接口协议可采用HTTP或HTTPS协议,接口请求方式为POST请求,采用同步方式进行。6.2 接口交换格式接口交换格式采用JSON传输数据,具备通用性和可扩展性。6.3 接口数据类型接口数据类型包括:字符串型(Strin
5、g);整数型(Int);小数型(Double);时间型(Date)。注: 对“时间”类信息,以“1970年1月1日,00:00:00(GTM时间)”作为基准起始时间。26.4 接口消息格式6.4.1 请求消息格式消息格式:由请求头和请求参数组成。请求头:不同接口具有统一请求头,请求头的名称及其含义描述应符合表1的规定。请求参数:请求参数格式见表2列表形式,根据不同接口功能,其请求参数不同。表1 接口请求头格式名称描述必选/可选Host指定请求的服务器的域名和端口号必选Connection表示是否需要持久链接必选Accept标识接受所接收的内容类型必选Content-Type请求的与实体对应的M
6、IME信息必选Content-Lentgh请求的内容长度必选Cookie请求发送时,会把保存在该请求域名下的所有cookie值一起发送给网站服务器可选User-Agent内容包含发出请求的用户信息可选Token访问连接的秘钥信息可选6.4.2 响应消息格式消息格式:由响应头和响应参数组成。响应头:不同接口具有统一响应头,响应头的名称及其含义描述应符合表3的规定。响应参数:响应参数格式见表4列表形式,根据不同接口功能,其响应参数不同。表3 接口响应头格式表4 接口响应参数格式6.4.3 接口协议内容关于接口规范的数据清单按照附录A的规定执行。3表2 接口请求参数格式参数名类型非空参数描述给出该字
7、段所代表的的参数名用于描述数据的数据类型描述该参数是否可以为空对参数的描述及补充说明名称描述必选/可选Content-Type请求的与实体对应的MIME信息必选Content-Lentgh请求的内容长度必选Date服务器消息发出的时间可选Server服务器软件名称可选参数名类型非空参数描述给出该字段所代表的的参数名用于描述数据的数据类型描述该参数是否可以为空对参数的描述及补充说明A A附 录 A(规范性)接口规范的数据清单A.1 市级气瓶追溯平台从省级气瓶追溯平台下载数据的接口A.1.1 市级平台身份认证接口A.1.1.1 接口方法及说明接口标识符:GetKey接口说明:本接口用于市级平台获取
8、身份认证密钥。A.1.1.2 接口输入参数及说明市级平台身份认证接口的输入参数及说明见表A.1。A.1.1.3 接口返回参数及说明市级平台身份认证接口返回参数及说明见表A.2。表A.2 市级平台身份认证接口返回参数及说明A.1.2 气瓶使用登记信息接口(车用气瓶除外)A.1.2.1 接口方法及说明接口标识符:Register_Cylinder接口说明:本接口用于查询气瓶的使用登记信息。A.1.2.2 接口输入参数及说明气瓶使用登记信息接口的输入参数及说明见表A.3。4表A.1 市级平台身份认证接口输入参数及说明参数名类型非空参数描述appCodeString是接入平台IDauthCodeStr
9、ing是接入方密钥参数名类型非空参数描述DataKeyString是身份认证密钥,调用业务接口时使用ExpireString是密钥过期时间(单位:秒)RtStatusString是响应状态码MsgString是响应状态描述FromSystemString是源系统名称表A.3 气瓶使用登记信息接口输入参数及说明参数名类型非空参数描述KeyString是身份密钥CertNoString否使用登记证编号ProNoString否气瓶编号PageInt否页数(默认为1)RowsInt否每页显示数(默认为10)A.1.2.3 接口返回参数及说明气瓶使用登记信息返回参数及说明见表A.4。表A.4 气瓶使用登
10、记信息接口返回参数及说明返回参数类型非空字段描述DataUnitNameString是产权单位名称ContactStaffString是产权单位联系人ContactNumberString是产权单位联系电话IsImportString是是否进口(0-是,1-否)EquVarietyString是设备品种(t1-无缝气瓶,t2焊接气瓶,t3-内装填料气瓶,t4-纤维缠绕气瓶,t5-低温绝热气瓶)ProNoString是气瓶编号ProduceUnitString是制造单位名称或代号ProduceDateDate是制造日期(yyyy-mm)FillingMediumString是充装介质(JZ01-
11、氨气,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是公称容积(单位:L)DesignWallThicknessString是设计壁厚(单位:mm)LastCheck
12、UnitString是最近检验机构LastCheckDateDate是最近检验日期(yyyy-mm)NextCheckDateDate是下次检验日期(yyyy-mm)RegisUnitString否登记机关(发证机关)RegisUserString否登记人员(发证人员)UseStatString是变更或停用情况(s1-在用,s2-停用,s3-注销,s4-报废)TagTypeString是标签类型(t1-二维码标签,t2-电子标签,t3-智能角阀,t4-其他,t5-无)TagNoString是标签编号CertNoString是使用登记证编号5A.1.3.3 接口返回参数及说明车用气瓶使用登记信息
13、返回参数及说明见表A.6。表A.6 车用气瓶使用登记信息接口返回参数及说明6表 A.4 (续)返回参数类型非空字段描述DataCreateTimeDate是录入时间(yyyy-MM-dd HH:mm:ss)UpDateTimeDate是更新时间(yyyy-MM-dd HH:mm:ss)A.1.3 车用气瓶使用登记信息接口A.1.3.1 接口方法及说明接口标识符:CyRegister_Cylinder接口说明:本接口用于查询车用气瓶使用登记信息。A.1.3.2 接口输入参数及说明车用气瓶使用登记气瓶信息接口的输入参数及说明见表A.5。表A.5 车用气瓶使用登记信息接口输入参数及说明参数名类型非空
14、参数描述KeyString是身份密钥CertNoString否使用登记证编号CarNumberString否车牌号ProNoString否气瓶编号PageInt否页数(默认为1)RowsInt否每页显示数(默认为10)返回参数类型非空字段描述DataCylinderIdString是系统内主键IdCarNumberString是车牌号CarVinNumberString是车辆VIN码CarProduceUnitString否车辆制造单位UseUnitString是使用单位名称UseUnitContactStaffString是使用单位联系人UseUnitContactTelString是使用单
15、位联系电话ProNoString是气瓶编号EquVarietyString是设备品种(t1-无缝气瓶,t2焊接气瓶,t3-内装填料气瓶,t4-纤维缠绕气瓶,t5-低温绝热气瓶)表 A.6 (续)返回参数类型非空字段描述DataFillingMediumString是充装介质(JZ01-氨气,JZ02-丙烷,JZ03-丙烯,JZ04- 氮气,JZ05-丁烷,JZ06-二氧化硫,JZ07-二氧化碳,JZ08-氢气,JZ09-溶解乙炔,JZ10-氩气,JZ11-氧气,JZ12- 液氨,JZ13-液二氧化碳,JZ14-液氯,JZ15-液氩,JZ16- 液氧,JZ17液氮,JZ18-LNG,JZ19-C
16、NG,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-dd HH:mm:ss)UpDateTimeDate是更新时间(yyyy-MM-dd HH:mm:ss)A.1.4 单位主体信息接口A.1.4.1 接口方法及说明接口标识符:OrgInfo接口说明:本接口用于获取气瓶设计单位、制造单位、充装单位和检验单位信息。A.1.4.2 接口输入参数及说明单位主体
18、信息接口的输入参数及说明见表A.7。7表A.7 单位主体接口输入参数及说明参数名类型非空参数描述KeyString是身份密钥UnitNatureString是单位类型(c1:气瓶充装单位;c2:车用气瓶充装单位;c3:工业气瓶充装单位:j4:气瓶检验单位:j5:车用气瓶检验单位;j6:工业气瓶检验单位;z7气瓶制造单位)UnitNameString是单位名称UnitCodeString否单位统一社会信用代码PageInt否页数(默认为1)RowsInt否每页显示数(默认为10)A.1.4.3 接口返回参数及说明单位主体信息返回参数及说明见表A.8。表A.8 单位主体信息接口返回参数及说明返回参
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB34T4531 2023 安徽省 质量 安全 追溯 信息 平台 数据 接口 规范
![提示](https://www.zixin.com.cn/images/bang_tan.gif)
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【Fis****915】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【Fis****915】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。