《DB23_T 3612-2023 黑龙江省政务信息共享交换平台级联对接规范.docx》由会员分享，可在线阅读，更多相关《DB23_T 3612-2023 黑龙江省政务信息共享交换平台级联对接规范.docx（97页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、ICS35.240.01CCSL67DB23黑龙江省地方标准DB23/T36122023黑龙江省政务信息共享交换平台级联对接规范2023年-08月-28日发布2023年-09月-27日实施黑龙江省市场监督管理局发布DB23/T36122023前言本文件依据GB/T1.1-2020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由黑龙江省营商环境建设监督局提出并归口。本文件起草单位：黑龙江省营商环境建设监督局、黑龙江省政务大数据中心、黑龙江省标准化研究院。本文件主要起草人：张建峰、王磊、江中阳、梁丽
2、、杨大志、李文学、吕猛、李黎轩、遇金宝、李硕IDB23/T36122023黑龙江省政务信息共享交换平台级联对接规范1范围本文件规定了政务信息资源数据共享交换平台的接口要求、目录级联、交换级联、供需级联等方面内容。本文件适用于黑龙江省市级共享平台与省级共享平台的数据目录、数据资源和供需数据的级联建设。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。DB23/T36132023黑龙江省政务信息共享交换平台政务数据资源术语3术语和定义DB23/T36
3、132023界定的以及下列术语和定义适用于本文件。3.1政务外网局域网接入政务外网的逻辑隔离区域，与部门其他网络之间有明确边界。4缩略语下列缩略语适用于本文件。API：应用程序接口，（ApplicationProgrammingInterface）（URL：每一信息资源都有统一的且在网上唯一的地址，该地址就叫URL，uniformresourcelocator）5级联架构5.1级联架构内容省市两级平台对接通过级联系统实现，级联系统包括省级联系统和地市级联系统两部分，省级联系统由省共享交换平台开发部署，地市级联系统由各地市建设。5.2省市两级数据共享交换平台对接架构省市两级数据共享交换平台对接架
4、构包括以下内容，见图1。1DB23/T36122023a)级联程序：级联程序将省级平台级联数据推送到下行数据表中；b)交换程序：完成省平台和地市平台之间数据交换；c)上行接口：将地市共享平台上行数据同步到省共享平台；d)上行数据表：存储地市共享平台上行数据，供使用方获取；e)下行数据表：存储省共享平台下行数据，供地市共享平台获取；f)文件系统：存储上报、下发的资源。图1省市两级数据共享交换平台对接架构图5.3省市两级对接设计省共享交换平台向地市共享交换平台下行数据通过推送到下行数据表供地市共享交换平台获取，地市共享交换平台提交的上行数据（含目录上行数据、供需上行数据、交换业务上行数据）通过上行
5、接口和数据交换到上行数据表的方式提交到省共享交换平台,相关数据字典详见附录A。6上行接口对接6.1接口对接规范6.1.1通讯协议http承载使用httpPOST/GET方法由请求方发送请求，由消息接收方回复响应。2属性名称约束类型取值说明gjgxjhpt_rid必选String请求者身份标识gjgxjhpt_sid必选String服务接口标识（本文档中每个接口都有一个方法名作为服务接口标识）gjgxjhpt_rtime必选String服务调用时间gjgxjhpt_sign必选String签名信息序号父元素元素名称约束类型长度取值说明1一code必选String60返回消息的状态码2一messa
6、ge必选String128返回消息结果描述3一data必选一一返回消息体DB23/T36122023注1：所有JSON消息中的字段均为小写（模版中有些使用大写字母，但是下发的报文中都使用小写）。注2：所有消息中的JSON数据均采用utf-8编码。6.1.2消息头要求6.1.2.1消息头字段消息头要求见表1。表1消息头要求表http消息头包含如下字段6.1.2.2参数签名信参数签名信息的生成需要使用签名秘钥计算，计算的方式为使用签名秘钥对请求者身份标识、服务接口标识、服务调用时间进行hmacsha256计算并进行base64转码获得。示例代码见附录B。注：请求者身份标识、服务标识、签名秘钥由省共
7、享交换平台分别向各地市下发，下发方式为邮件。6.1.3消息头对消息头的参数定义,各个字段解释见表2。表2消息头的参数定义表6.1.4消息正文消息正文为交易请求以及应答的内容，以JSON格式存储，在交易报文传输时和消息头一起传输。6.1.5报文样例6.1.5.1样例场景目录分类创建，市平台在创建目录分类后，调用省平台的目录分类注册接口，实现目录分类的同步注册。6.1.5.2http请求样例接口请求报文，包括消息头和消息正文两部分，如下所示：示例：3DB23/T36122023http消息头gjgxjhpt_sid:/Supply/CreateOrggjgxjhpt_rid:CreateCataL
8、ogGroupgjgxjhpt_rtime:2018-10-2311:09:12gjgxjhpt_sign:q98d7vc98q98era97fbn0sa67fnbaq5fhttp请求报文id:201001,name:公共卫生,parent_id:201,remark:政务信息资源分类-公共卫生,order_id:16.1.5.3http响应样例接口请求的响应报文，仅包含消息头部分，如下所示：示例：code:0,message:添加成功6.2组织机构信息查询6.2.1机构查询接口机构查询接口见表3、表4和表5。4名称机构单位查询接口功能说明地市共享平台用以查询省平台机构单位的share_org
9、_idURL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/Supply/CreateOrg内容类型application/json提交资源数据按照本文件表4执行提交httpheader数据按照本文件6.1.2.1执行提交数据举例region_code:230100,/国家统计局网站发布统计用区划代码（region_name:黑龙江省哈尔滨市市辖区,/国家统计局网站发布的统计用区划代码dept_name:哈尔滨市交通运输局,dept_code:11230100002277193D/单位组织机构编码返回http状态200返回数据参数
10、按照本文件表5执行返回数据举例code:1,message:处理成功,data:share_org_id:12454名称是否必须类型长度描述region_code是String36统计用区划代码（国家统计局网站2017年10月31发布，省市县（区）采用6位）region_name是String250统计用区划名字（国家统计局网站2017年10月31发布）dept_name是String255机构单位名称dept_code是String36单位组织机构编码（请参照GB/T31286-2014标准填写）credit_code否String50统一信用代码DB23/T36122023表3机构查询接口
11、表表4机构查询接口-提交资源数据格式表5名称目录分类注册接口功能说明地市共享平台注册目录分类到省平台URL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/CatalogGroup/CreateCataLogGroup提交资源数据按照本文件表7执行提交httpheader数据按照本文件6.1.2.1执行提交数据举例parent_id:307013114,group_name:工商局,remark:工商局,order_id:22返回http状态200返回数据参数按照本文件表8执行返回数据举例（处理正常）code:1,message:处
12、理成功,data:group_id:3070260158名称是否必须类型长度描述group_name是String32分类名称parent_id是String32上级分类id（同一级分类最大支持99个子分类）remark否String100分类描述order_id否Int8排序编号名称类型长度描述codeInt6执行结果代码messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）data一一返回数据share_org_idString36机构idDB23/T36122023表5机构查询接口-返回数据参数格式表6.3目录分类上行6.3.1目录分类注册接口目录分类注册接口见
13、表6、表7和表8。表6目录分类注册接口表表7目录分类注册接口-提交资源数据格式表6名称目录分类变更接口功能说明地市共享平台变更本地市在省平台的目录分类URL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/CatalogGroup/UpdateCataLogGroup提交资源数据按照本文件表10执行提交httpheader数据按照本文件6.1.2.1执行提交数据举例group_id:3070131112,/必填parent_id:30701311,group_name:工商局部门,remark:工商局部门,order_id:23返回
14、http状态200返回数据参数按照本文件表11执行返回数据举例（处理正常）code:1,message:处理成功名称是否必须类型长度描述group_id是String32目录分类id（需要变更的目录分类id）group_name是String32分类名称（可变更）parent_id是String32上级分类id（需要变更的目录分类的上级分类id）remark否String100分类描述（可变更）order_id否Int8排序编号（可变更）名称类型长度描述codeInt6执行结果代码data一一返回数据group_idString32省平台的目录分类idmessageString一执行结果信息（
15、和结果代码对应，是执行结果的说明信息）DB23/T36122023表8目录分类注册接口-返回数据参数格式表6.3.2目录分类变更接口目录分类变更接口见表9、表10和表11。表9目录分类变更接口表表10目录分类变更接口-提交资源数据格式表7名称目录分类撤销接口功能说明地市共享平台撤销本地市在省平台的目录分类URL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/CatalogGroup/DeleteCataLogGroup提交资源数据按照本文件表13执行提交httpheader数据按照本文件6.1.2.1执行提交数据举例group_i
16、d:目录分类id/必填返回http状态200返回数据参数按照本文件表14执行返回数据举例（处理正常）code:1,message:处理成功名称类型长度描述codeInt6执行结果代码messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）名称是否必须类型长度描述group_id是String32目录分类idDB23/T36122023表11目录分类变更接口-返回数据参数格式表6.3.3目录分类撤销接口目录分类撤销接口见表12、表13和表14。表12目录分类撤销接口表表13目录分类撤销接口-提交资源数据格式表8名称目录注册接口功能说明地市共享平台将本地市的目录注册到省平台
17、URL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/Catalog/CreateCataLog提交资源数据按照本文件表16执行提交httpheader数据按照本文件6.1.2.1执行名称类型长度描述codeInt6执行结果代码messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）DB23/T36122023表14目录分类撤销接口-返回数据参数格式表6.4目录信息上报6.4.1目录注册接口6.4.1.1目录注册接口表目录注册接口见表15、表16和表17。表15目录注册接口表9名称目录注册接口提交数据举例c
18、ata_title:水土流失监测管理信息,catacode:307013097898,cataid:307013200304123456,columnlist:dataformat:1,columnid:123134,length:100,namecn:机关代码,updatetime:2017-12-2516:38:11,credit_code:X08100000000000000,description:水土流失监测管理信息,group_id:307013200304,internalorgan:string,open_condition:无,publishedtime:open_type:
19、1,2017-10-2622:30:00,resourceformat:03,resourceformatother:string,resourceformattype:0307,shared_condition:无,shared_type:1,sharedway:0102,status:4,update_cycle:1,updatetime:2017-10-2622:30:00返回http状态200返回数据参数按照本文件表17执行返回数据举例（处理正常）code:1,data:cata_id:1510727521903027532,message:处理成功DB23/T36122023表15目
20、录注册接口表（续）10名称是否必须类型长度描述group_id是String32所属目录分类编码cataid是String32省平台数据目录标识id（长度限制为32字符，各省保持唯一）cata_title是String512省平台目录名称catacode是String100信息资源目录编码credit_code是String32统一信用代码internalorgan否String100提供方内部部门description是String1024信息资源摘要resourceformat是String20信息资源格式分类编码resourceformattype是String20信息资源格式类型编码r
21、esourceformatother否String100其他类型资源格式描述columnlist否catalogcolumn_schema一当信息资源格式为电子表格和数据库类型时，数据项项列表信息必须填写，其他资源格式可以不上报，但若上报必须符合格式校验publishedtime是date一发布日期shared_type是String20共享类型编码shared_condition是String200共享条件sharedway是String20共享方式类型编码（open_type是Int20开放类型（1：可对社会开放，2：不可对社会开放；3：部分对社会开放）open_condition是Str
22、ing1024开放条件（对向社会开放资源的条件描述。如无条件，请填写无）updatetime是datatime一更新时间update_cycle是String10更新周期status是Int一目录状态（省平台已发布的目录注册到国家平台为“4”）名称类型长度描述codeInt6执行结果代码data一一返回数据cata_idString32省平台的目录idmessageString一执行结果信息（和结果代码对应，是执行结果的说明信息）DB23/T36122023表16目录注册接口-提交资源数据格式表表17目录注册接口-返回数据参数格式表6.4.1.2catalogcolumn_schema描述ca
23、talogcolumn_schema描述见表18。11名称目录变更接口功能说明地市共享平台变更本地市在省平台的目录URL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/Catalog/UpdateCataLog提交资源数据按照本文件表20执行提交httpheader数据按照本文件6.1.2.1执行字段名是否必须类型长度说明columnid否String32信息项编码namecn是String100信息项名称dataformat是String20数据类型编码length是Int20数据长度order_id是Int11排序编号upda
24、tetime是datatime一更新时间DB23/T36122023表18catalogcolumn_schema描述表6.4.2目录变更接口6.4.2.1目录变更接口表目录变更接口表见表19、表20和表21。表19目录变更接口表12名称目录变更接口提交数据举例cata_id:71ec43d27af74c7e9a63bc7c08e9ea9c,cata_title:水土流失监测管理信息,columnlist:dataformat:1,update_cycle:8,columnid:123134,length:100,namecn:机关代码,updatetime:2017-12-2516:38:1
25、1,description:水土流失监测管理信息,internalorgan:string,open_condition:无,open_type:1,publishedtime:2017-10-2622:30:00,resourceformatother:resourceformat:03,string,resourceformattype:0307,shared_condition:无,shared_type:1,sharedway:0102,update_cycle:1,updatetime:2017-10-2622:30:00返回http状态200返回数据参数按照本文件表21执行返回数据
26、举例（处理正常）code:1,message:处理成功名称是否必须类型长度描述cata_id是String32省平台的目录idcata_title是String512信息资源名称internalorgan可选String100提供方内部部门DB23/T36122023表19目录变更接口表（续）表20目录变更接口-提交资源数据格式表13名称是否必须类型长度描述description是String1024信息资源摘要resourceformat是String20信息资源格式分类编码resourceformattype是String20信息资源格式类型编码resourceformatother否St
27、ring100其他类型资源格式描述columnlist否catalogcolumn_schema一当信息资源格式为电子表格和数据库类型时，数据项项列表信息必须填写，其他资源格式可以不上报，但若上报必须符合格式校验（详见Scheema定义）publishedtime是date一发布日期shared_type是String20共享类型编码shared_condition是String200共享条件sharedway是Int20共享方式类型编码open_type是Int20开放类型（1：可对社会开放，2：不可对社会开放；3：部分对社会开放）open_condition是String1024开放条件（
28、对向社会开放资源的条件描述。如无条件，请填写无）updatetime是datatime一更新时间update_cycle是String10更新周期字段名是否必须类型长度说明columnid否String32信息项编码namecn是String100信息项名称dataformat是String20数据类型编码length是Int20数据长度update_cycle是String20更新周期编码update_cycle_user否String200更新周期为自定义时，可填写自定义更新周期updatetime是datatime一更新时间名称类型长度描述codeInt6执行结果代码messageStr
29、ing一执行结果信息（和结果代码对应，是执行结果的说明信息）DB23/T36122023表20目录变更接口-提交资源数据格式表（续）表21目录变更接口-返回数据参数格式表6.4.2.2catalogcolumn_schema描述catalogcolumn_schema描述见表22。表22catalogcolumn_schema描述14名称目录撤销接口功能说明地市共享平台撤销本身在省平台的目录URL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/Catalog/DeleteCataLog提交资源数据按照本文件表24执行提交httph
30、eader数据按照本文件6.1.2.1执行提交数据举例cata_id:1521534283920593740,cataid:1031123456222223返回http状态200返回数据参数按照本文件表25执行返回数据举例（处理正常）code:1,message:处理成功名称是否必须类型长度描述cata_id是String32省平台的目录idcataid是String32地市平台数据目录标识id名称类型长度描述codeInt6执行结果代码messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）DB23/T361220236.4.3目录撤销接口目录撤销接口见表23、表24
31、和表25。表23目录撤销接口表表24目录撤销接口-提交资源数据格式表表25目录撤销接口-返回数据参数格式表6.5应用系统信息上报6.5.1应用系统注册接口应用系统注册接口见表26、表27和表28。15名称应用系统注册接口功能说明资源申请时需要选择相对应的应用系统，此接口将地市平台的应用系统注册到省平台。URL样式https:/xx.xx.xx.xx/interface提交方式POST接口协议https+JSON方法名/Supply/CreateSystem内容类型application/json提交资源数据按照本文件表27执行提交httpheader数据按照本文件6.1.2.1执行提交数据举例
32、name:农业信息管理系统,share_org_id:农业信息管理系统,provide_ip:127.0.0.1,provide_url:remark:,phone:13231313131,contact:张三,area_name:01,range_name:01返回http状态200返回数据参数按照本文件表28执行返回数据举例（处理正常）code:1,data:id:234234,message:处理成功名称是否必须类型长度描述name是String255应用系统名称share_org_id是String15机构id（机构注册接口返回的机构id）provide_ip是String15对外提供
33、的ipprovide_url是String255对外提供的url地址remark否String255备注phone是String15联系人电话contact是String36联系人姓名area_name是String50应用领域名称（见附录A.数据字典.应用领域名称）range_name是String50应用范围名称(01:全省；02：全市；03：本单位)DB23/T36122023表26应用系统注册接口表表27应用系统注册接口-提交资源数据格式表16名称应用系统修改接口功能说明对于已经注册成功的应用系统进行修改。URL样式https:/xx.xx.xx.xx/interface提交方式POS
34、T方法名/Supply/UpdateSystem接口协议https+JSON内容类型application/json提交资源数据按照本文件表30执行提交httpheader数据按照本文件6.1.2.1章执行提交数据举例id:df-1,name:农业信息管理系统,provide_ip:127.0.0.1,provide_url:remark:,phone:13231313131,contact:张三,返回http状态200返回数据参数按照本文件表31执行返回数据举例（处理正常）code:1,message:处理成功名称类型长度描述codeInt6执行结果代码（详见附录A.2返回码定义）messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）