ICS 35.240.01 CCS L 67 DB23 黑龙江省地方标准 DB23/T 3612—2023 黑龙江省政务信息共享交换平台 级联对接规范 2023年-08月-28日发布 2023年-09月-27日实施 黑龙江省市场监督管理局 发布 DB23/T 3612—2023 I 前 言 本文件依据GB/T 1.1 -2020《标准化工作导则 第1 部分：标准化文件的结构和起草规则》的规定起 草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本文件由黑龙江省营商环境建设监督局提出并归口。 本文件起草单位：黑龙江省营商环境建设监督局、黑龙江省政务大数据中心、黑龙江省标准化研究 院。 本文件主要起草人：张建峰、王磊、 江中阳、梁丽、杨大志、李文学、 吕猛、李黎轩、遇金宝、 李 硕 DB23/T 3612—2023 1 黑龙江省政务信息共享交换平台 级联对接规范 1 范围 本文件规定了政务信息资源数据共享交换平台的接口要求、目录级联、交换级联、供需级联等方面 内容。 本文件适用于黑龙江省市级共享平台与省级共享平台的数据目录、数据资源和供需数据的级联建 设。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 DB23/T 3613—2023 黑龙江省政务信息共享交换平台政务数据资源术语 3 术语和定义 DB23/T 3613—2023 界定的以及下列术语和定义适用于本文件。 3.1 政务外网局域网 接入政务外网的逻辑隔离区域，与部门其他网络之间有明确边界。 4 缩略语 下列缩略语适用于本文件。 API：应用程序接口，（Application Programming Interface） URL： 每一信息资源都有统一的且在网上唯一的地址， 该地址就叫URL ，（uniform resource locator） 5 级联架构 5.1 级联架构内容 省市两级平台对接通过级联系统实现，级联系统包括省级联系统和地市级联系统两部分，省级联系 统由省共享交换平台开发部署，地市级联系统由各地市建设。 5.2 省市两级数据共享交换平台对接架构 省市两级数据共享交换平台对接架构包括以下内容，见图1 。 DB23/T 3612—2023 2 a) 级联程序：级联程序将省级平台级联数据推送到下行数据表中； b) 交换程序：完成省平台和地市平台之间数据交换； c) 上行接口：将地市共享平台上行数据同步到省共享平台； d) 上行数据表：存储地市共享平台上行数据，供使用方获取； e) 下行数据表：存储省共享平台下行数据，供地市共享平台获取； f) 文件系统：存储上报、下发的资源。 图1 省市两级数据共享交换平台对接架构图 5.3 省市两级对接设计 省共享交换平台向地市共享交换平台下行数据通过推送到下行数据表供地市共享交换平台获取， 地 市共享交换平台提交的上行数据（含目录上行数据、供需上行数据、交换业务上行数据）通过上行接口 和数据交换到上行数据表的方式提交到省共享交换平台, 相关数据字典详见附录A 。 6 上行接口对接 6.1 接口对接规范 6.1.1 通讯协议 http承载使用 http POST/GET 方法由请求方发送请求，由消息接收方回复响应。 DB23/T 3612—2023 3 注1：所有 JSON消息中的字段均为小写（模版中有些使用大写字母，但是下发的报文中都使用小写）。 注2：所有消息中的 JSON数据均采用 utf-8编码。 6.1.2 消息头要求 6.1.2.1 消息头字段 消息头要求见表1 。 表1 消息头要求表 http消息头包含如下字段 属性名称 约束 类型 取值说明 gjgxjhpt_rid 必选 String 请求者身份标识 gjgxjhpt_sid 必选 String 服务接口标识（本文档中每个接口都有一个方法名作 为服务接口标识） gjgxjhpt_rtime 必选 String 服务调用时间 gjgxjhpt_sign 必选 String 签名信息 6.1.2.2 参数签名信 参数签名信息的生成需要使用签名秘钥计算，计算的方式为使用签名秘钥对请求者身份标识、服务 接口标识、服务调用时间进行hmacsha256 计算并进行base64 转码获得。示例代码见附录B 。 注：请求者身份标识、服务标识、签名秘钥由省共享交换平台分别向各地市下发，下发方式为邮件。 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 样例场景 目录分类创建，市平台在创建目录分类后，调用省平台的目录分类注册接口，实现目录分类的同步 注册。 6.1.5.2 http请求样例 接口请求报文，包括消息头和消息正文两部分，如下所示： 示例： DB23/T 3612—2023 4 http消息头 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":"政务信息资源分类-公共卫生", "order_id":"1" } 6.1.5.3 http响应样例 接口请求的响应报文，仅包含消息头部分，如下所示： 示例： { "code":"0", "message":"添加成功" } 6.2 组织机构信息查询 6.2.1 机构查询接口 机构查询接口见表3 、表4和表5。 DB23/T 3612—2023 5 表3 机构查询接口表 名称 机构单位查询接口 功能说明 地市共享平台用以查询省平台机构单位的 share_org_id URL样式 https:// xx.xx.xx.xx /interface 提交方式 POST 接口协议 https+JSON 方法名 /Supply/CreateOrg 内容类型 application/json 提交资源数据 按照本文件表 4执行 提交http header数据 按照本文件 6.1.2.1执行 提交数据举例 { "region_code": " 230100", //国家统计局网站发布统计用区划代码 （https://www.stats.gov.cn/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_code 是 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 3612—2023 6 表5 机构查询接口- 返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码 message String 一 执行结果信息（和结果代码对应，是执行结果的说明信息） data 一 一 返回数据 share_org_id String 36 机构id 6.3 目录分类上行 6.3.1 目录分类注册接口 目录分类注册接口见表6 、表7和表8。 表6 目录分类注册接