DB23 T 3612-2023 黑龙江省政务信息共享交换平台 级联对接规范.pdf
《DB23 T 3612-2023 黑龙江省政务信息共享交换平台 级联对接规范.pdf》由会员分享,可在线阅读,更多相关《DB23 T 3612-2023 黑龙江省政务信息共享交换平台 级联对接规范.pdf(87页珍藏版)》请在麦多课文档分享上搜索。
1、ICS 35.240.01 CCS L 67 DB23黑龙江省地方标准 DB23/T 36122023 黑龙江省政务信息共享交换平台 级联对接规范 2023 年-08 月-28 日发布2023 年-09 月-27 日实施黑龙江省市场监督管理局 发 布 DB23/T 36122023 I前 言 本文件依据GB/T 1.1-2020标准化工作导则 第1 部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由黑龙江省营商环境建设监督局提出并归口。本文件起草单位:黑龙江省营商环境建设监督局、黑龙江省政务大数据中心、黑龙江省标准
2、化研究院。本文件主要起草人:张建峰、王磊、江中阳、梁丽、杨大志、李文学、吕猛、李黎轩、遇金宝、李硕DB23/T 36122023 1黑龙江省政务信息共享交换平台 级联对接规范 1 范围 本文件规定了政务信息资源数据共享交换平台的接口要求、目录级联、交换级联、供需级联等方面内容。本文件适用于黑龙江省市级共享平台与省级共享平台的数据目录、数据资源和供需数据的级联建设。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。DB23/T 36132023
3、 黑龙江省政务信息共享交换平台政务数据资源术语 3 术语和定义 DB23/T 36132023 界定的以及下列术语和定义适用于本文件。3.1 政务外网局域网 接入政务外网的逻辑隔离区域,与部门其他网络之间有明确边界。4 缩略语 下列缩略语适用于本文件。API:应用程序接口,(Application Programming Interface)URL:每一信息资源都有统一的且在网上唯一的地址,该地址就叫URL,(uniform resource locator)5 级联架构 5.1 级联架构内容 省市两级平台对接通过级联系统实现,级联系统包括省级联系统和地市级联系统两部分,省级联系统由省共享交换
4、平台开发部署,地市级联系统由各地市建设。5.2 省市两级数据共享交换平台对接架构 省市两级数据共享交换平台对接架构包括以下内容,见图1。DB23/T 36122023 2a)级联程序:级联程序将省级平台级联数据推送到下行数据表中;b)交换程序:完成省平台和地市平台之间数据交换;c)上行接口:将地市共享平台上行数据同步到省共享平台;d)上行数据表:存储地市共享平台上行数据,供使用方获取;e)下行数据表:存储省共享平台下行数据,供地市共享平台获取;f)文件系统:存储上报、下发的资源。图1 省市两级数据共享交换平台对接架构图 5.3 省市两级对接设计 省共享交换平台向地市共享交换平台下行数据通过推送
5、到下行数据表供地市共享交换平台获取,地市共享交换平台提交的上行数据(含目录上行数据、供需上行数据、交换业务上行数据)通过上行接口和数据交换到上行数据表的方式提交到省共享交换平台,相关数据字典详见附录A。6 上行接口对接 6.1 接口对接规范 6.1.1 通讯协议 http承载使用http POST/GET方法由请求方发送请求,由消息接收方回复响应。DB23/T 36122023 3注1:所有 JSON 消息中的字段均为小写(模版中有些使用大写字母,但是下发的报文中都使用小写)。注2:所有消息中的 JSON 数据均采用 utf-8 编码。6.1.2 消息头要求 6.1.2.1 消息头字段 消息头
6、要求见表1。表1 消息头要求表 http消息头包含如下字段 属性名称 约束 类型 取值说明 gjgxjhpt_rid 必选 String 请求者身份标识 gjgxjhpt_sid 必选 String 服务接口标识(本文档中每个接口都有一个方法名作为服务接口标识)gjgxjhpt_rtime 必选 String 服务调用时间 gjgxjhpt_sign 必选 String 签名信息 6.1.2.2 参数签名信 参数签名信息的生成需要使用签名秘钥计算,计算的方式为使用签名秘钥对请求者身份标识、服务接口标识、服务调用时间进行hmacsha256计算并进行base64转码获得。示例代码见附录B。注:请
7、求者身份标识、服务标识、签名秘钥由省共享交换平台分别向各地市下发,下发方式为邮件。6.1.3 消息头 对消息头的参数定义,各个字段解释见表2。表2 消息头的参数定义表 序号 父元素 元素名称 约束 类型 长度 取值说明 1 一 code 必选 String 60 返回消息的状态码 2 一 message 必选 String 128 返回消息结果描述 3 一 data 必选 一 一 返回消息体 6.1.4 消息正文 消息正文为交易请求以及应答的内容,以JSON格式存储,在交易报文传输时和消息头一起传输。6.1.5 报文样例 6.1.5.1 样例场景 目录分类创建,市平台在创建目录分类后,调用省平
8、台的目录分类注册接口,实现目录分类的同步注册。6.1.5.2 http 请求样例 接口请求报文,包括消息头和消息正文两部分,如下所示:示例:DB23/T 36122023 4http 消息头 gjgxjhpt_sid:/Supply/CreateOrg gjgxjhpt_rid:CreateCataLogGroup gjgxjhpt_rtime:2018-10-23 11:09:12 gjgxjhpt_sign:q98d7vc98q98era97fbn0sa67fnbaq5f http 请求报文 id:201001,name:公共卫生,parent_id:201,remark:政务信息资源分类
9、-公共卫生,order_id:1 6.1.5.3 http 响应样例 接口请求的响应报文,仅包含消息头部分,如下所示:示例:code:0,message:添加成功 6.2 组织机构信息查询 6.2.1 机构查询接口 机构查询接口见表3、表4和表5。DB23/T 36122023 5表3 机构查询接口表 名称 机构单位查询接口 功能说明 地市共享平台用以查询省平台机构单位的 share_org_id URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/Supply/CreateOrg 内容类型 application
10、/json 提交资源数据 按照本文件表 4 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 提交数据举例 region_code:230100,/国家统计局网站发布统计用区划代码(https:/ dept_name:哈尔滨市交通运输局,dept_code:11230100002277193D/单位组织机构编码 返回 http 状态 200 返回数据参数 按照本文件表 5 执行 返回数据举例 code:1,message:处理成功,data:share_org_id:12454 表4 机构查询接口-提交资源数据格式表 名称 是否必须 类型 长度 描述 region_c
11、ode 是 String 36 统计用区划代码(国家统计局网站 2017 年10 月 31 发布,省市县(区)采用 6 位)region_name 是 String 250 统计用区划名字(国家统计局网站 2017 年10 月 31 发布)dept_name 是 String 255 机构单位名称 dept_code 是 String 36 单位组织机构编码(请参照 GB/T 31286-2014标准填写)credit_code 否 String 50 统一信用代码 DB23/T 36122023 6表5 机构查询接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果
12、代码 message String 一 执行结果信息(和结果代码对应,是执行结果的说明信息)data 一 一 返回数据 share_org_id String 36 机构 id 6.3 目录分类上行 6.3.1 目录分类注册接口 目录分类注册接口见表6、表7和表8。表6 目录分类注册接口表 名称 目录分类注册接口 功能说明 地市共享平台注册目录分类到省平台 URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/CatalogGroup/CreateCataLogGroup 提交资源数据 按照本文件表 7 执行 提交
13、http header 数据 按照本文件 6.1.2.1 执行 提交数据举例 parent_id:307013114,group_name:工商局,remark:工商局,order_id:22 返回 http 状态 200 返回数据参数 按照本文件表 8 执行 返回数据举例(处理正常)code:1,message:处理成功,data:group_id:3070260158 表7 目录分类注册接口-提交资源数据格式表 名称 是否必须 类型 长度 描述 group_name 是 String 32 分类名称 parent_id 是 String 32 上级分类 id(同一级分类最大支持 99 个子
14、分类)remark 否 String 100 分类描述 order_id 否 Int 8 排序编号 DB23/T 36122023 7表8 目录分类注册接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码 data 一 一 返回数据 group_id String 32 省平台的目录分类 id message String 一 执行结果信息(和结果代码对应,是执行结果的说明信息)6.3.2 目录分类变更接口 目录分类变更接口见表9、表10和表11。表9 目录分类变更接口表 名称 目录分类变更接口 功能说明 地市共享平台变更本地市在省平台的目录分类 URL 样式
15、https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/CatalogGroup/UpdateCataLogGroup 提交资源数据 按照本文件表 10 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 提交数据举例 group_id:3070131112,/必填 parent_id:30701311,group_name:工商局部门,remark:工商局部门,order_id:23 返回 http 状态 200 返回数据参数 按照本文件表 11 执行 返回数据举例(处理正常)code:1,message:
16、处理成功 表10 目录分类变更接口-提交资源数据格式表 名称 是否必须 类型 长度 描述 group_id 是 String 32 目录分类 id(需要变更的目录分类 id)group_name 是 String 32 分类名称(可变更)parent_id 是 String 32 上级分类 id(需要变更的目录分类的上级分类 id)remark 否 String 100 分类描述(可变更)order_id 否 Int 8 排序编号(可变更)DB23/T 36122023 8表11 目录分类变更接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码 message
17、String 一 执行结果信息(和结果代码对应,是执行结果的说明信息)6.3.3 目录分类撤销接口 目录分类撤销接口见表12、表13和表14。表12 目录分类撤销接口表 名称 目录分类撤销接口 功能说明 地市共享平台撤销本地市在省平台的目录分类 URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/CatalogGroup/DeleteCataLogGroup 提交资源数据 按照本文件表 13 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 提交数据举例 group_id:目录分类 id/
18、必填 返回 http 状态 200 返回数据参数 按照本文件表 14 执行 返回数据举例(处理正常)code:1,message:处理成功 表13 目录分类撤销接口-提交资源数据格式表 名称 是否必须 类型 长度 描述 group_id 是 String 32 目录分类 id DB23/T 36122023 9表14 目录分类撤销接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码 message String 一 执行结果信息(和结果代码对应,是执行结果的说明信息)6.4 目录信息上报 6.4.1 目录注册接口 6.4.1.1 目录注册接口表 目录注册接口见表
19、15、表16和表17。表15 目录注册接口表 名称 目录注册接口 功能说明 地市共享平台将本地市的目录注册到省平台 URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/Catalog/CreateCataLog 提交资源数据 按照本文件表 16 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 DB23/T 36122023 10表 15 目录注册接口表(续)名称 目录注册接口 提交数据举例 cata_title:水土流失监测管理信息,catacode:307013097898,catai
20、d:307013200304123456,columnlist:dataformat:1,columnid:123134,length:100,namecn:机关代码,updatetime:2017-12-25 16:38:11 ,credit_code:X08100000000000000,description:水土流失监测管理信息,group_id:307013200304,internalorgan:string,open_condition:无,open_type:1,publishedtime:2017-10-26 22:30:00,resourceformat:03,resour
21、ceformatother:string,resourceformattype:0307,shared_condition:无,shared_type:1,sharedway:0102,status:4,update_cycle:1,updatetime:2017-10-26 22:30:00 返回 http 状态 200 返回数据参数 按照本文件表 17 执行 返回数据举例(处理正常)code:1,data:cata_id:1510727521903027532,message:处理成功 DB23/T 36122023 11表16 目录注册接口-提交资源数据格式表 名称 是否必须 类型 长度
22、 描述 group_id 是 String 32 所属目录分类编码 cataid 是 String 32 省平台数据目录标识 id(长度限制为 32 字符,各省保持唯一)cata_title 是 String 512 省平台目录名称 catacode 是 String 100 信息资源目录编码 credit_code 是 String 32 统一信用代码 internalorgan 否 String 100 提供方内部部门 description 是 String 1024 信息资源摘要 resourceformat 是 String 20 信息资源格式分类编码 resourceformatt
23、ype 是 String 20 信息资源格式类型编码 resourceformatother 否 String 100 其他类型资源格式描述 columnlist 否 catalogcolumn_schema 一 当信息资源格式为电子表格和数据库类型时,数据项项列表信息必须填写,其他资源格式可以不上报,但若上报必须符合格式校验 publishedtime 是 date 一 发布日期 shared_type 是 String 20 共享类型编码 shared_condition 是 String 200 共享条件 sharedway 是 String 20 共享方式类型编码(open_type
24、是 Int 20 开放类型(1:可对社会开放,2:不可对社会开放;3:部分对社会开放)open_condition 是 String 1024 开放条件(对向社会开放资源的条件描述。如无条件,请填写无)updatetime 是 datatime 一 更新时间 update_cycle 是 String 10 更新周期 status 是 Int 一 目录状态(省平台已发布的目录注册到国家平台为“4”)表17 目录注册接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码 data 一 一 返回数据 cata_id String 32 省平台的目录 id messag
25、e String 一 执行结果信息(和结果代码对应,是执行结果的说明信息)6.4.1.2 catalogcolumn_schema 描述 catalogcolumn_schema描述见表18。DB23/T 36122023 12表18 catalogcolumn_schema 描述表 字段名 是否必须 类型 长度 说明 columnid 否 String 32 信息项编码 namecn 是 String 100 信息项名称 dataformat 是 String 20 数据类型编码 length 是 Int 20 数据长度 order_id 是 Int 11 排序编号 updatetime 是
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB23 3612-2023 黑龙江省政务信息共享交换平台 级联对接规范 3612 2023 黑龙江省 政务信息 共享 交换 平台 级联 对接 规范
