《DB23∕T 3612-2023 黑龙江省政务信息共享交换平台 级联对接规范(黑龙江省).pdf》由会员分享，可在线阅读，更多相关《DB23∕T 3612-2023 黑龙江省政务信息共享交换平台 级联对接规范(黑龙江省).pdf（87页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
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 36
3、132023 黑龙江省政务信息共享交换平台政务数据资源术语 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 2 a)级联程序：级联程序将省级平台级联数据推送到下行数据表中；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转码获得。示例代码
7、见附录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 样例场景 目录分类创建，市平台在创建目录
8、分类后，调用省平台的目录分类注册接口，实现目录分类的同步注册。6.1.5.2 http 请求样例 接口请求报文，包括消息头和消息正文两部分，如下所示：示例：DB23/T 36122023 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
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 内容类型 a
10、pplication/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 机构查询接口-提交资源数据格式表 名称 是否必须 类型 长度 描
11、述 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 36122023 6 表5 机构查询接口-返回数据参数格式表 名称 类型 长度 描述 code
12、 Int 6 执行结果代码 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 提交资源数据 按照本文
13、件表 7 执行 提交 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（同一级分
14、类最大支持 99 个子分类）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 目录分类变更接口表 名称 目录分类变更接口 功能说明 地市共享平台变更本地市在省平台的
15、目录分类 URL 样式 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 执行 返回数据举例（处理正常）cod
16、e:1,message:处理成功 表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 执行
17、结果代码 message 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 执行 提交数据举例 grou
18、p_id:目录分类 id/必填 返回 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:307
20、013097898,cataid: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,resourcef
21、ormat:03,resourceformatother: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 信息资源格式分类编码
23、 resourceformattype 是 String 20 信息资源格式类型编码 resourceformatother 否 String 100 其他类型资源格式描述 columnlist 否 catalogcolumn_schema 一 当信息资源格式为电子表格和数据库类型时，数据项项列表信息必须填写，其他资源格式可以不上报，但若上报必须符合格式校验 publishedtime 是 date 一 发布日期 shared_type 是 String 20 共享类型编码 shared_condition 是 String 200 共享条件 sharedway 是 String 20 共享方
24、式类型编码（open_type 是 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
25、省平台的目录 id message 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
26、排序编号 updatetime 是 datatime 一 更新时间 6.4.2 目录变更接口 6.4.2.1 目录变更接口表 目录变更接口表见表19、表20和表21。表19 目录变更接口表 名称 目录变更接口 功能说明 地市共享平台变更本地市在省平台的目录 URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/Catalog/UpdateCataLog 提交资源数据 按照本文件表 20 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 DB23/T 36122023 13 表 19 目录变更
27、接口表（续）名称 目录变更接口 提交数据举例 cata_id:71ec43d27af74c7e9a63bc7c08e9ea9c,cata_title:水土流失监测管理信息,columnlist:dataformat:1,update_cycle:8,columnid:123134,length:100,namecn:机关代码,updatetime:2017-12-25 16:38:11 ,description:水土流失监测管理信息,internalorgan:string,open_condition:无,open_type:1,publishedtime:2017-10-26 22:30:
28、00,resourceformat:03,resourceformatother:string,resourceformattype:0307,shared_condition:无,shared_type:1,sharedway:0102,update_cycle:1,updatetime:2017-10-26 22:30:00 返回 http 状态 200 返回数据参数 按照本文件表 21 执行 返回数据举例（处理正常）code:1,message:处理成功 表20 目录变更接口-提交资源数据格式表 名称 是否必须 类型 长度 描述 cata_id 是 String 32 省平台的目录 id
29、 cata_title 是 String 512 信息资源名称 internalorgan 可选 String 100 提供方内部部门 DB23/T 36122023 14 表 20 目录变更接口-提交资源数据格式表（续）名称 是否必须 类型 长度 描述 description 是 String 1024 信息资源摘要 resourceformat 是 String 20 信息资源格式分类编码 resourceformattype 是 String 20 信息资源格式类型编码 resourceformatother 否 String 100 其他类型资源格式描述 columnlist 否 ca
30、talogcolumn_schema 一 当信息资源格式为电子表格和数据库类型时，数据项项列表信息必须填写，其他资源格式可以不上报，但若上报必须符合格式校验（详见 Scheema 定义）publishedtime 是 date 一 发布日期 shared_type 是 String 20 共享类型编码 shared_condition 是 String 200 共享条件 sharedway 是 Int 20 共享方式类型编码 open_type 是 Int 20 开放类型（1：可对社会开放，2：不可对社会开放；3：部分对社会开放）open_condition 是 String 1024 开放条
31、件（对向社会开放资源的条件描述。如无条件，请填写无）updatetime 是 datatime 一 更新时间 update_cycle 是 String 10 更新周期 表21 目录变更接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码 message String 一 执行结果信息（和结果代码对应，是执行结果的说明信息）6.4.2.2 catalogcolumn_schema 描述 catalogcolumn_schema描述见表22。表22 catalogcolumn_schema 描述 字段名 是否必须 类型 长度 说明 columnid 否 Strin
32、g 32 信息项编码 namecn 是 String 100 信息项名称 dataformat 是 String 20 数据类型编码 length 是 Int 20 数据长度 update_cycle 是 String 20 更新周期编码 update_cycle_user 否 String 200 更新周期为自定义时，可填写自定义更新周期 updatetime 是 datatime 一 更新时间 DB23/T 36122023 15 6.4.3 目录撤销接口 目录撤销接口见表23、表24和表25。表23 目录撤销接口表 名称 目录撤销接口 功能说明 地市共享平台撤销本身在省平台的目录 URL
33、 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/Catalog/DeleteCataLog 提交资源数据 按照本文件表 24 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 提交数据举例 cata_id:1521534283920593740,cataid:1031123456222223 返回 http 状态 200 返回数据参数 按照本文件表 25 执行 返回数据举例（处理正常）code:1,message:处理成功 表24 目录撤销接口-提交资源数据格式表 名称 是否必须 类型 长度
34、 描述 cata_id 是 String 32 省平台的目录 id cataid 是 String 32 地市平台数据目录标识 id 表25 目录撤销接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码 message String 一 执行结果信息（和结果代码对应，是执行结果的说明信息）6.5 应用系统信息上报 6.5.1 应用系统注册接口 应用系统注册接口见表26、表27和表28。DB23/T 36122023 16 表26 应用系统注册接口表 名称 应用系统注册接口 功能说明 资源申请时需要选择相对应的应用系统，此接口将地市平台的应用系统注册到省平台。UR
35、L 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 方法名/Supply/CreateSystem 内容类型 application/json 提交资源数据 按照本文件表 27 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 提交数据举例 name:农业信息管理系统,share_org_id:农业信息管理系统,provide_ip:127.0.0.1,provide_url:https:/ 返回 http 状态 200 返回数据参数 按照本文件表 28 执行 返回数据举例（处理正常）code:1,d
36、ata:id:234234,message:处理成功 表27 应用系统注册接口-提交资源数据格式表 名称 是否必须 类型 长度 描述 name 是 String 255 应用系统名称 share_org_id 是 String 15 机构 id（机构注册接口返回的机构 id）provide_ip 是 String 15 对外提供的 ip provide_url 是 String 255 对外提供的 url 地址 remark 否 String 255 备注 phone 是 String 15 联系人电话 contact 是 String 36 联系人姓名 area_name 是 String
37、50 应用领域名称（见附录 A.数据字典.应用领域名称）range_name 是 String 50 应用范围名称(01:全省；02：全市；03：本单位)DB23/T 36122023 17 表28 应用系统注册接口-返回数据参数格式表 名称 类型 长度 描述 code Int 6 执行结果代码（详见附录 A.2 返回码定义）message String 一 执行结果信息（和结果代码对应，是执行结果的说明信息）data 一 一 返回数据 id String 36 应用系统 id 6.5.2 应用系统修改接口 应用系统修改接口见表29、表30和表31。表29 应用系统修改接口 名称 应用系统修改
38、接口 功能说明 对于已经注册成功的应用系统进行修改。URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 方法名/Supply/UpdateSystem 接口协议 https+JSON 内容类型 application/json 提交资源数据 按照本文件表 30 执行 提交 http header 数据 按照本文件 6.1.2.1 章执行 提交数据举例 id:df-1,name:农业信息管理系统,provide_ip:127.0.0.1,provide_url:https:/ http 状态 200 返回数据参数 按照本文件表 31 执行 返回数据举例（处
39、理正常）code:1,message:处理成功 DB23/T 36122023 18 表30 应用系统修改接口-提交资源数据格式表 名称 是否必须 类型 长度 描述 id 是 String 36 应用系统 id name 是 String 255 应用系统名称 provide_ip 是 String 15 对外提供的 ip provide_url 是 String 255 对外提供的 url 地址 remark 否 String 255 备注 phone 是 String 15 联系人电话 contact 是 String 36 联系人姓名 表31 应用系统修改接口-返回数据参数格式表 名称
40、类型 长度 描述 code Int 6 执行结果代码（详见附录 A.2 返回码定义）message String 一 执行结果信息（和结果代码对应，是执行结果的说明信息）6.6 资源信息上报 6.6.1 数据源接口 6.6.1.1 数据源注册接口 数据源注册接口见表32、表33和表34。表32 数据源注册接口 名称 Datasource 增加接口 功能说明 新建数据源时，将数据源的相关信息推送给资源系统 url 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 调用方法/Resource/CreateDatasource 传入参
41、数 Map 提交资源数据 按照本文件表 33 执行 提交 http header数据 按照本文件 6.1.2.1 执行 DB23/T 36122023 19 表 32 数据源注册接口（续）名称 Datasource 增加接口 提交数据举例 id:02d0783ac13041eebb7252f3f4464f6e,name:测试数据源,description:测试数据源描述,host:127.0.0.1,port:3306,dbName:test,dbType:mysql,username:root,password:CNy2pjoPzhBSTVQsMOUhZw=,contactName:test
42、2,contactPhone:13388886666,jdbcType:sid,schema:public,organCode:370100,organName:哈尔滨市公安局,regionCode:230100000000 返回 http 状态 200 返回数据参数 按照本文件表 34 执行 返回数据举例（处理正常）正常返回:code:200,error:,data:02d0783ac13041eebb7252f3f4464f6e 表33 数据源注册接口-提交资源数据格式表 名称 类型 必填 说明 备注 name String 是 数据源名称 一 description String 否 数
43、据源描述 一 host String 是 主机地址 一 port Int 是 端口号 一 dbName String 是 数据库名称 一 dbType String 是 数据库类型 Mysql，oracle，Postgresql，sqlserver username String 是 用户名 一 DB23/T 36122023 20 表 33 数据源注册接口-提交资源数据格式表（续）名称 类型 必填 说明 备注 password String 是 数据源密码，加密存储 与老系统加密方式一致，可以直接存储 contactName String 否 联系人 一 contactPhone Strin
44、g 否 联系电话 一 jdbcType String 是 Sid 或 serviceName 一 schema String 否 一 一 organCode String 是 数据源所属部门信息 从 meta_host 中取出 org_code organName String 是 数据源所属部门名称 从 meta_host 中取出 org_name regionCode String 是 数据源所属区划信息 一 表34 数据源注册接口-返回数据参数格式表 名称 类型 说明 备注 code Int 返回参数 200 推送成功、300 推送失败 error String 返回信息 提示信息：失败
45、返回失败信息，成功返回空 data String 资源 id 若新增数据源成功则返回新数据源的资源 id，若更新数据源或推送失败则返回空 6.6.1.2 数据源删除接口 数据源删除接口见表35、表36和表37。表35 数据源删除接口 名称 资源删除服务 功能说明 数据源删除时，将资源及相关信息推送给资源系统 URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 调用方法/Resource/DeleteDatasource 传入参数 String 提交资源数据 按照本文件表 36 执行 提交 http header 数据 按照
46、本文件 6.1.2.1 执行 提交数据举例 id:5e19071306fe4663850eac8795235c0c,返回 http 状态 200 返回数据参数 按照本文件表 37 执行 返回数据举例（处理正常）正常返回:code:200,error:,DB23/T 36122023 21 表36 数据源删除接口-提交资源数据格式表 名称 类型 必填 说明 备注 id String 是 资源 id 需要删除资源的资源 id 表37 数据源删除接口-返回数据参数格式表 名称 类型 说明 备注 code Int 返回参数 200 推送成功 300 推送失败 error String 返回信息 提示信
47、息：失败返回失败信息，成功返回空，6.6.1.3 数据源更新接口 数据源更新接口见表38、表39和表40。表38 数据源更新接口 名称 Datasource 增加接口 功能说明 新建数据源时，将数据源的相关信息推送给资源系统 URL 样式 https:/xx.xx.xx.xx/interface 提交方式 POST 接口协议 https+JSON 调用方法/Resource/UpdateDatasource 传入参数 Map 提交资源数据 按照本文件表 39 执行 提交 http header 数据 按照本文件 6.1.2.1 执行 提交数据举例 id:02d0783ac13041eebb72
48、52f3f4464f6e,name:测试数据源,description:测试数据源描述,host:127.0.0.1,port:3306,dbName:test,dbType:mysql,username:root,password:CNy2pjoPzhBSTVQsMOUhZw=,contactName:test2,contactPhone:13388886666,jdbcType:sid,schema:public,organCode:370100,organName:哈尔滨市公安局,regionCode:230100000000 DB23/T 36122023 22 表 38 数据源更新接
49、口（续）名称 Datasource 增加接口 返回 http 状态 200 返回数据参数 按照本文件表 40 执行 返回数据举例（处理正常）正常返回:code:200,error:,data:02d0783ac13041eebb7252f3f4464f6e 表39 数据源更新接口-提交资源数据格式表 名称 类型 必填 说明 备注 id String 是 数据源 id 主键，当推送的 id 不为空时，资源系统根据推送的 id 对已有数据源进行更新，若id为空则新生成一个资源id作为资源系统的主键，并存储在 data 字段中返回 name String 是 数据源名称 一 description
50、String 否 数据源描述 一 host String 是 主机地址 一 port Int 是 端口号 一 dbName String 是 数据库名称 一 dbType String 是 数据库类型 Mysql，oracle，Postgresql，sqlserver username String 是 用户名 一 password String 是 数据源密码，加密存储 与老系统加密方式一致，可以直接存储 contactName String 否 联系人 一 contactPhone String 否 联系电话 一 jdbcType String 是 Sid 或 serviceName 一