DB23/T 3612-2023 黑龙江省政务信息共享交换平台 级联对接规范

ICS35.240.01

CCSL67

DB23

黑龙江省地方标准

DB23/T3612—2023

黑龙江省政务信息共享交换平台

级联对接规范

2023年-08月-28日发布2023年-09月-27日实施

黑龙江省市场监督管理局发布

DB23/T3612—2023

前言

本文件依据GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起

草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

本文件由黑龙江省营商环境建设监督局提出并归口。

本文件起草单位：黑龙江省营商环境建设监督局、黑龙江省政务大数据中心、黑龙江省标准化研究

院。

本文件主要起草人：张建峰、王磊、江中阳、梁丽、杨大志、李文学、吕猛、李黎轩、遇金宝、李

硕

I

DB23/T3612—2023

黑龙江省政务信息共享交换平台

级联对接规范

1范围

本文件规定了政务信息资源数据共享交换平台的接口要求、目录级联、交换级联、供需级联等方面

内容。

本文件适用于黑龙江省市级共享平台与省级共享平台的数据目录、数据资源和供需数据的级联建

设。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

DB23/T3613—2023黑龙江省政务信息共享交换平台政务数据资源术语

3术语和定义

DB23/T3613—2023界定的以及下列术语和定义适用于本文件。

3.1

政务外网局域网

接入政务外网的逻辑隔离区域，与部门其他网络之间有明确边界。

4缩略语

下列缩略语适用于本文件。

API：应用程序接口，（ApplicationProgrammingInterface）

URL：每一信息资源都有统一的且在网上唯一的地址，该地址就叫URL，（uniformresourcelocator）

5级联架构

5.1级联架构内容

省市两级平台对接通过级联系统实现，级联系统包括省级联系统和地市级联系统两部分，省级联系

统由省共享交换平台开发部署，地市级联系统由各地市建设。

5.2省市两级数据共享交换平台对接架构

省市两级数据共享交换平台对接架构包括以下内容，见图1。

1

DB23/T3612—2023

a)级联程序：级联程序将省级平台级联数据推送到下行数据表中；

b)交换程序：完成省平台和地市平台之间数据交换；

c)上行接口：将地市共享平台上行数据同步到省共享平台；

d)上行数据表：存储地市共享平台上行数据，供使用方获取；

e)下行数据表：存储省共享平台下行数据，供地市共享平台获取；

f)文件系统：存储上报、下发的资源。

图1省市两级数据共享交换平台对接架构图

5.3省市两级对接设计

省共享交换平台向地市共享交换平台下行数据通过推送到下行数据表供地市共享交换平台获取，地

市共享交换平台提交的上行数据（含目录上行数据、供需上行数据、交换业务上行数据）通过上行接口

和数据交换到上行数据表的方式提交到省共享交换平台,相关数据字典详见附录A。

6上行接口对接

6.1接口对接规范

6.1.1通讯协议

http承载使用httpPOST/GET方法由请求方发送请求，由消息接收方回复响应。

2

DB23/T3612—2023

注1：所有JSON消息中的字段均为小写（模版中有些使用大写字母，但是下发的报文中都使用小写）。

注2：所有消息中的JSON数据均采用utf-8编码。

6.1.2消息头要求

消息头字段

消息头要求见表1。

表1消息头要求表

http消息头包含如下字段

属性名称约束类型取值说明

gjgxjhpt_rid必选String请求者身份标识

gjgxjhpt_sid服务接口标识（本文档中每个接口都有一个方法名作

必选String

为服务接口标识）

gjgxjhpt_rtime必选String服务调用时间

gjgxjhpt_sign必选String签名信息

参数签名信

参数签名信息的生成需要使用签名秘钥计算，计算的方式为使用签名秘钥对请求者身份标识、服务

接口标识、服务调用时间进行hmacsha256计算并进行base64转码获得。示例代码见附录B。

注：请求者身份标识、服务标识、签名秘钥由省共享交换平台分别向各地市下发，下发方式为邮件。

6.1.3消息头

对消息头的参数定义,各个字段解释见表2。

表2消息头的参数定义表

序号父元素元素名称约束类型长度取值说明

1一code必选String60返回消息的状态码

2一message必选String128返回消息结果描述

3一data必选一一返回消息体

6.1.4消息正文

消息正文为交易请求以及应答的内容，以JSON格式存储，在交易报文传输时和消息头一起传输。

6.1.5报文样例

样例场景

目录分类创建，市平台在创建目录分类后，调用省平台的目录分类注册接口，实现目录分类的同步

注册。

http请求样例

接口请求报文，包括消息头和消息正文两部分，如下所示：

示例：

3

DB23/T3612—2023

http消息头

gjgxjhpt_sid:/Supply/CreateOrg

gjgxjhpt_rid:CreateCataLogGroup

gjgxjhpt_rtime:2018-10-2311:09:12

gjgxjhpt_sign:q98d7vc98q98era97fbn0sa67fnbaq5f

http请求报文

{

"id":"201001",

"name":"公共卫生",

"parent_id":"201",

"remark":"政务信息资源分类-公共卫生",

"order_id":"1"

}

http响应样例

接口请求的响应报文，仅包含消息头部分，如下所示：

示例：

{

"code":"0",

"message":"添加成功"

}

6.2组织机构信息查询

6.2.1机构查询接口

机构查询接口见表3、表4和表5。

4

DB23/T3612—2023

表3机构查询接口表

名称机构单位查询接口

功能说明地市共享平台用以查询省平台机构单位的share_org_id

URL样式https://xx.xx.xx.xx/interface

提交方式POST

接口协议https+JSON

方法名/Supply/CreateOrg

内容类型application/json

提交资源数据按照本文件表4执行

提交http按照本文件执行

header数据

提交数据举例{

"region_code":"230100",//国家统计局网站发布统计用区划代码

（/tjsj/tjbz/tjyqhdmhcxhfdm/2017/index.html）

"region_name":"黑龙江省哈尔滨市市辖区",//国家统计局网站发布的统计用区划代码

"dept_name":"哈尔滨市交通运输局",

"dept_code":"11230100002277193D"//单位组织机构编码

}

返回http状态200

返回数据参数按照本文件表5执行

返回数据举例{

"code":"1",

"message":"处理成功",

"data":"{"share_org_id":"12454"}"

}

表4机构查询接口-提交资源数据格式表

名称是否必须类型长度描述

region_codeString36统计用区划代码（国家统计局网站2017年

是

10月31发布，省市县（区）采用6位）

region_nameString250统计用区划名字（国家统计局网站2017年

是

10月31发布）

dept_name是String255机构单位名称

dept_codeString36单位组织机构编码（请参照GB/T31286-2014

是

标准填写）

credit_code否String50统一信用代码

5

DB23/T3612—2023

表5机构查询接口-返回数据参数格式表

名称类型长度描述

codeInt6执行结果代码

messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）

data一一返回数据

share_org_idString36机构id

6.3目录分类上行

6.3.1目录分类注册接口

目录分类注册接口见表6、表7和表8。

表6目录分类注册接口表

名称目录分类注册接口

功能说明地市共享平台注册目录分类到省平台

URL样式https://xx.xx.xx.xx/interface

提交方式POST

接口协议https+JSON

方法名/CatalogGroup/CreateCataLogGroup

提交资源数据按照本文件表7执行

提交http按照本文件执行

header数据

提交数据举例{

"parent_id":"307013114",

"group_name":"工商局",

"remark":"工商局",

"order_id":"22"

}

返回http状态200

返回数据参数按照本文件表8执行

返回数据举例{

（处理正常）"code":"1",

"message":"处理成功",

"data":"{"group_id":"3070260158"}"

}

表7目录分类注册接口-提交资源数据格式表

名称是否必须类型长度描述

group_name是String32分类名称

parent_id是String32上级分类id（同一级分类最大支持99个子分类）

remark否String100分类描述

order_id否Int8排序编号

6

DB23/T3612—2023

表8目录分类注册接口-返回数据参数格式表

名称类型长度描述

codeInt6执行结果代码

data一一返回数据

group_idString32省平台的目录分类id

messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）

6.3.2目录分类变更接口

目录分类变更接口见表9、表10和表11。

表9目录分类变更接口表

名称目录分类变更接口

功能说明地市共享平台变更本地市在省平台的目录分类

URL样式https://xx.xx.xx.xx/interface

提交方式POST

接口协议https+JSON

方法名/CatalogGroup/UpdateCataLogGroup

提交资源数据按照本文件表10执行

提交http按照本文件执行

header数据

提交数据举例{

"group_id":"3070131112",//必填

"parent_id":"30701311",

"group_name":"工商局部门",

"remark":"工商局部门",

"order_id":"23"

}

返回http状态200

返回数据参数按照本文件表11执行

返回数据举例{

（处理正常）"code":"1",

"message":"处理成功"

}

表10目录分类变更接口-提交资源数据格式表

名称是否必须类型长度描述

group_id是String32目录分类id（需要变更的目录分类id）

group_name是String32分类名称（可变更）

parent_id是String32上级分类id（需要变更的目录分类的上级分类id）

remark否String100分类描述（可变更）

order_id否Int8排序编号（可变更）

7

DB23/T3612—2023

表11目录分类变更接口-返回数据参数格式表

名称类型长度描述

codeInt6执行结果代码

messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）

6.3.3目录分类撤销接口

目录分类撤销接口见表12、表13和表14。

表12目录分类撤销接口表

名称目录分类撤销接口

功能说明地市共享平台撤销本地市在省平台的目录分类

URL样式https://xx.xx.xx.xx/interface

提交方式POST

接口协议https+JSON

方法名/CatalogGroup/DeleteCataLogGroup

提交资源数据按照本文件表13执行

提交http按照本文件执行

header数据

提交数据举例{

"group_id":"目录分类id"//必填

}

返回http状态200

返回数据参数按照本文件表14执行

{

返回数据举例"code":"1",

（处理正常）"message":"处理成功"

}

表13目录分类撤销接口-提交资源数据格式表

名称是否必须类型长度描述

group_id是String32目录分类id

8

DB23/T3612—2023

表14目录分类撤销接口-返回数据参数格式表

名称类型长度描述

codeInt6执行结果代码

messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）

6.4目录信息上报

6.4.1目录注册接口

目录注册接口表

目录注册接口见表15、表16和表17。

表15目录注册接口表

名称目录注册接口

功能说明地市共享平台将本地市的目录注册到省平台

URL样式https://xx.xx.xx.xx/interface

提交方式POST

接口协议https+JSON

方法名/Catalog/CreateCataLog

提交资源数据按照本文件表16执行

提交http按照本文件执行

header数据

9

DB23/T3612—2023

表15目录注册接口表（续）

名称目录注册接口

提交数据举例{

"cata_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":"无",

"open_type":1,

"publishedtime":"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":"处理成功"

}

10

DB23/T3612—2023

表16目录注册接口-提交资源数据格式表

名称是否必须类型长度描述

group_id是String32所属目录分类编码

省平台数据目录标识id（长度限制为32字符，各省保

cataid是String32

持唯一）

cata_title是String512省平台目录名称

catacode是String100信息资源目录编码

credit_code是String32统一信用代码

internalorgan否String100提供方内部部门

description是String1024信息资源摘要

resourceformat是String20信息资源格式分类编码

resourceformatt信息资源格式类型编码

是String20

ype

resourceformato

否String100其他类型资源格式描述

ther

当信息资源格式为电子表格和数据库类型时，数据项项

catalogcol

columnlist否一列表信息必须填写，其他资源格式可以不上报，但若上

umn_schema

报必须符合格式校验

publishedtime是date一发布日期

shared_type是String20共享类型编码

shared_conditioString200共享条件

是

n

sharedway是String20共享方式类型编码（

open_typeInt20开放类型（1：可对社会开放，2：不可对社会开放；3：

是

部分对社会开放）

开放条件（对向社会开放资源的条件描述。如无条件，

open_condition是String1024

请填写无）

updatetime是datatime一更新时间

update_cycle是String10更新周期

目录状态（省平台已发布的目录注册到国家平台为

status是Int一

“4”）

表17目录注册接口-返回数据参数格式表

名称类型长度描述

codeInt6执行结果代码

data一一返回数据

cata_idString32省平台的目录id

messageString一执行结果信息（和结果代码对应，是执行结果的说明信息）

catalogcolumn_schema描述

catalogcolumn_schema描述见表18。

11

DB23/T3612—2023

表18catalogcolumn_schema描述表

字段名是否必须类型长度说明

columnid否String32信息项编码

namecn是String100信息项名称

dataformat是String20数据类型编码

length是Int20数据长度

order_id是Int11排序编号

updatetime是datatime一更新时间

6.4.2目录变更接口

目录变更接口表

目录变更接口表见表19、表20和表21。

表19目录变更接口表

名称目录变更接口

功能说明地市共享平台变更本地市在省平台的目录

URL样式https://xx.xx.xx.xx/interface

提交方式POST

接口协议https+JSON

方法名/Catalog/UpdateCataLog

提交资源数据按照本文件表20执行

提交http