2022气瓶质量安全追溯系统第2部分：数据接口

气瓶质量安全追溯系统2II目 次范围 1规范性引用文件 1术语和定义 1缩略语 1总体要求 2接口消息格式 2接口基本功能和参数 3参考文献 1111气瓶质量安全追溯系统第2部分：数据接口范围本文件规定了气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数。本文件适用于液化石油气气瓶和液化二甲醚气瓶的气瓶质量安全追溯系统的数据接口。规范性引用文件（包括所有的修改单适用于本文件。GB/T13000 （UCS）RFC2616 超文本传输协议1.1（HypertextTransferProtocol—HTTP/1.1）RFC4627JSON应用与媒体类型[Theapplication/jsonMediaTypeforJavaScriptObjectNotation(JSON)]术语和定义下列术语和定义适用于本文件。3.1气瓶信息化标签实现气瓶生命周期中充装验证和追溯的信息化媒介。3.2编码字符集一组明确的规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。[来源：GB/T1988-1998，4.6]缩略语下列缩略语适用于本文件。GTM：格林威治时间（GreenwichMeanTime）HTML：超文本置标语言（HyperTextMarkupHTTP：超文本传输协议（HyperTextTransferProtocol）HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer或HypertextTransferProtocolSecure）ID：标识符（Identifier）JSON：轻量级的数据交换格式（JavaScriptObjectNotation）MIME：多用途互联网邮件扩展（MultipurposeInternetMail22总体要求通信协议应采用符合RFC2616的HTTP或HTTPS。接口描述宜使用标准化的或比较通用的文本描述语言，如JSON（RFC4627）。编码字符集应符合GB/T13000的要求。数据类型气瓶质量安全追溯系统数据接口应覆盖所能支持数据类型，包括：——字符串型（String）；——数字型（Number）；——时间型（DateTime）；——对象型（Object）；——数组型（Array）；——布尔型（Boolean）；——空（NULL）。注：对“时间”类信息，以“1970年1月1日，00:00:00（GTM时间）”作为基准起始时间。接口消息格式请求消息格式消息格式请求消息由请求头和请求参数组成。应使用HTTP规定的POST请求方法。请求头不同接口具有统一请求头，请求头的名称及其含义描述应符合表1的规定。表1请求头名称描述必选/可选Host指定请求的服务器的域名和端口号必选Connection表示是否需要持久连接必选Accept表示接受所接收的内容类型必选Content-Type请求的与实体对应的MIME信息必选Content-Lentgh请求的内容长度必选33表1（续）名称描述必选/可选CookieHTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给网站服务器可选User-Agent内容包含发出请求的用户信息可选Token访问连接的密钥信息可选请求参数请求参数格式见示例列表形式，根据不同接口功能，其请求参数不同。示例：参数名数据类型必选/可选描述给出该字段所代表的参数名用于描述数据的数据类型描述该参数是否为必选对参数的描述及补充说明----响应消息格式消息格式响应消息由响应头和响应消息参数组成。应使用HTTP规定的POST请求方法。响应头不同接口具有同一响应头，响应头的名称及其含义描述应符合表2的规定。表2响应头名称描述必选/可选Content-Type请求的与实体对应的MIME信息必选Content-Length请求的内容长度必选Date服务器消息发出的时间可选Server服务器软件名称可选响应参数响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数不同。示例：参数名数据类型必选/可选描述给出该字段所代表的参数名用于描述数据的数据类型描述该参数是否为必选对参数的描述及补充说明----接口基本功能和参数接口流程企业平台向监管平台上报数据或请求数据的接口流程应符合图1，接口的流程如下：企业平台发出请求，上报数据或请求数据；监管平台对该次请求进行处理；44处理后由监管平台向企业平台返回处理结果。图1接口流程初始化连通接口功能用于企业平台和监管平台间建立初始化连通。请求参数初始化连通请求参数应符合表3的规定。表3初始化连通请求参数参数名数据类型必选/可选描述app_idString必选接入方IDapp_keyString必选接入方功能板块信息app_secretString必选接入方密钥响应消息参数初始化连通响应消息参数应符合表4的规定。表4初始化连通响应消息参数参数名数据类型必选/可选描述statusNumber必选本次请求处理状态码msgString必选本次请求处理结果描述access_tokenString必选接入获取到的密钥expriesNumber必选密钥过期时间55请求类接口请求类接口列表请求类接口列表应符合表5的规定。表5请求类接口列表中文名称英文名称必选/可选气瓶基本信息product必选气瓶充装信息fill必选气瓶检验信息check可选气瓶信息化标签信息tag可选请求类接口基本功能和参数气瓶基本信息功能用于企业平台查询监管平台内气瓶基本信息。请求参数气瓶基本信息请求参数应符合表6的规定。表6气瓶基本信息请求参数参数名数据类型必选/可选描述inner_codeString必选查询气瓶的单位内编码响应消息参数气瓶基本信息响应信息参数应符合表7的规定。表7气瓶基本信息响应消息参数名称数据类型必选/可选描述pro_varietyString必选设备品种pro_nameString必选产品名称pro_noString必选气瓶生产编号fill_mediaNumber必选充装介质：0液化石油气，1二甲醚，2氧气，3二氧化碳，4溶解乙炔make_unitString必选制造单位make_timeDateTime必选生产日期work_pressureNumber必选公称工作压⼒（MPa）volumeNumber必选容积（L）check_timeDateTime必选最近⼒次检验⼒日期（新瓶该值填写出厂日期）66表7（续）名称数据类型必选/可选描述next_check_timeDateTime必选（4要送检验站检验的日期）regist_codeString可选气瓶使登记代码change_eventString可选变更情况（主要记录产权过户日志）memoString可选备注inner_codeString必选单位内编号stamp_make_unitString可选气瓶钢印制造单位名称pro_uuidString必选产品唯一性编码chip_idString可选芯片id（每一个批次生成的登记证编号）locationString可选（00010002006客户statusString必选气瓶状态[在用（已检测、停用（待检测submitusingstop检测)，scrapped报废check_organizationString可选检测机构empty_bottleBoolean必选是否空瓶：0是，1不是product_idString可选产品类型IDuidString可选高频编码tidString可选超高频编码chip_statusBoolean必选是否改造：0未改造，1已改造location_source_idString可选当前归属机构IDis_loseBoolean必选是否丢失：0丢失，1未丢失old_bottleBoolean必选是否旧瓶design_thicknessNumber必选设计壁厚result_codeString可选检测结果audit_remarkString可选审批备注deadline_timeDateTime必选使用年限check_in_timeDateTime必选录入日期scrap_timeDateTime可选报废日期analysis_statusString必选统计状态值：inform已提交待审批，using在用，scrapped报废check_statusBoolean必选1已证，0未证operation_idString必选操作人idoperation_timeDateTime必选操作时间safe_evaluateBoolean必选安全评定气瓶充装信息功能用于企业平台查询监管平台内气瓶最新一条充装信息。77请求参数气瓶充装信息请求参数应符合表8的规定。表8气瓶充装信息请求参数参数名数据类型必选/可选描述inner_codeString必选查询气瓶的单位内编码响应消息参数气瓶充装信息响应消息参数应符合表9的规定。表9气瓶充装信息响应消息参数名称数据类型必选/可选说明gun_codeString必选充装枪编号station_idString必选充装气站IDcompany_idString必选充装企业IDareaString必选所在区cityString必选所在市person_codeString必选充装人员编码user_idString必选充装人员idinner_codeString必选单位内编号chip_uidString必选高频编码pro_uuidString必选气瓶uuidproduct_idNumber必选产品类型idproduct_media_idNumber必选充装介质编码fill_timeDateTime必选充装时间create_timeDateTime必选创建时间气瓶定期检验信息功能用于企业平台查询监管平台内气瓶最新检验信息。请求参数气瓶定期检验信息请求参数应符合表10的规定。表10气瓶定期检验信息请求参数参数名数据类型必选/可选描述order_noString必选气瓶检验订单编号inner_codeString可选查询气瓶的单位内编码响应消息参数气瓶定期检验信息响应消息参数应符合表11的规定，气瓶定期检验明细应符合表12的规定。88表11气瓶定期检验信息响应消息参数名称数据类型必选/可选说明security_personString必选安全管理员unit_phoneString必选单位固定电话pro_use_addressString必选设备使用单位地点pro_numNumber必选设备数量use_unit_addressString必选使用单位地址use_unitString必选使用单位名称use_unit_fill_personString必选使用单位填表人员unit_social_codeString必选单位统一社会信用代码use_unit_fill_dateDateTime必选填表日期use_unit_phoneString必选移动电话pro_listArray<Object>必选气瓶定期检验明细表12气瓶定期检验明细名称数据类型必选/可选说明batch_noString必选登记编号ori_bottle_statusString必选原气瓶状态check_statusNumber必选03，4，5，6deal_flagBoolean必选是否完成检验：0未完成，1已完成is_safe_evaluateBoolean必选是否安全评定next_check_timeDateTime可选下次检验日期scrap_typeString可选报废处理方式create_timeDateTime必选创建时间check_timeDateTime必选检验时间气瓶信息化标签信息功能用于企业平台查询监管平台内气瓶信息化标签信息。请求参数气瓶信息化标签信息请求参数应符合表13的规定。表13气瓶信息化标签信息请求参数参数名数据类型必选/可选描述inner_codeString必选查询气瓶的单位内编码99响应消息参数气瓶信息化标签信息响应消息参数应符合表14的规定。表14气瓶信息化标签信息响应消息参数名称数据类型必选/可选说明uidString可选高频编码high_dataString可选高频芯片块数据tidString可选超高频编码ultra_high_dataString可选超高频块数据union_idString必选关联idqr_idString可选二维码idchip_keyString可选秘钥status_idBoolean必选绑定状态：0未绑定，1已绑定company_idString可选生产厂家create_timeDateTime必选入库时间上报类接口上报类接口列表应符合表15的规定。表15上报类接口列表中文名称英文名称必选/可选气瓶流转信息circulation必选上报类接口基本功能和参数气瓶流转信息功能送信息。请求参数气瓶流转信息请求参数应符合表16的规定。表16气瓶流转信息请求参数名称数据类型必选/可选说明pro_uuidString必选气瓶uuid1010表16（续）名称数据类型必选/可选说明inner_codeString可选气瓶单位内编码opt_typeString必选气瓶操作类型：重瓶装车，重瓶卸车，重瓶入库，重瓶出库，重瓶配送，空瓶回收，空瓶入库，空瓶装车，空瓶卸车memoString可选气瓶操作说明op