ICS 35.240.99 P 55 山 DB37 东 省 地 方 标 准 DB37/T 3859—2020 河（湖）长制管理平台数据交换接口 Data exchange interface of management platform for river (lake) chief system 2020 - 02 - 25 发布 山东省市场监督管理局 2020 - 03 - 25 实施 发 布 DB37/T 3859—2020 目 次 前言 ................................................................................ II 1 范围 .............................................................................. 1 2 术语和定义 ........................................................................ 1 3 数据交换结构 ...................................................................... 1 4 数据交换接口 ...................................................................... 2 4.1 4.2 4.3 4.4 4.5 4.6 应用注册接口 .................................................................. 2 基本信息接口 .................................................................. 3 河湖数据接口 .................................................................. 6 巡河（湖）数据接口 ........................................................... 11 涉河（湖）事件数据接口 ....................................................... 13 清违整治数据接口 ............................................................. 16 I DB37/T 3859—2020 前 言 本标准按照GB/T 1.1—2009给出的规则起草。 本标准由山东省水利厅提出、归口并组织实施。 本标准起草单位：山东省水利综合事业服务中心。 本标准主要起草人：张衍福、刘汉刚、葛召华、李红超、王茜、庄磊、李莹、郭伟、王华昌。 本标准为首次发布。 II DB37/T 3859—2020 河（湖）长制管理平台数据交换接口 1 范围 本标准规定了河（湖）长制省级管理平台与市级管理平台之间的数据交换接口。 本标准适用于河（湖）长制省级管理平台与市级管理平台之间的数据交换与共享。 2 术语和定义 下列术语和定义适用于本文件。 2.1 河（湖）长制 river（lake） chief system 由各级党政领导担任河（湖）长，组织领导相应河流（湖泊）管理和保护工作的制度。 2.2 管理平台 management platform 为河（湖）长制管理工作提供基础信息、河湖巡查、监督管理、河湖治理、考核评价、综合分析等 管理决策与支撑服务的信息系统。 2.3 数据交换 data exchange 各类实体之间相互提供数据的过程。 [GB/T 36107—2018，定义3.1] 3 数据交换结构 河（湖）长制管理平台数据交换体系结构见图1。 1 DB37/T 3859—2020 微信公众号 省级巡河（湖） 数据 省级巡河（湖） 事件 监督数据 监督数据 河湖基础信息 互联网 / VPN /专线 省级管理平台 省级 河湖数据库 互联网 / VPN / 专线 市级管理平台 市级管理平台 市级 河湖数据库 市级 河湖数据库 互联网 / VPN /专线 公众微信号 巡河（湖）数据 巡河（湖）事件 图1 4 监督数据 事件处理信息 清违整治处理 信息 河（湖）长制管理平台数据交换体系架构 数据交换接口 4.1 应用注册接口 4.1.1 注册申请接口 注册申请接口： a) 接口描述：省级管理平台应用注册申请接口，市级管理平台注册时调用该接口； b) 接口原型：String appRegisterApply (String jsonMap)； c) 请求参数：见表 1； 表1 参数 注册申请接口请求参数 名称 类型 是否必填 appAdcd 注册的行政区划编码 String 是 appId 应用编码 String 是 appName 应用名称 String 是 appIp 应用 Ip 地址 String 是 2 DB37/T 3859—2020 表 1 注册申请接口请求参数（续） 参数 名称 类型 是否必填 appMac 应用所在服务器 Mac String 是 appLinker 应用联系人 String 是 appPhone 联系人手机号 String 是 d) 返回参数：见表 2。 表2 注册申请接口返回参数 参数 值 status 状态 0 成功，1 失败 message 消息 4.1.2 许可查询接口 许可查询接口： a) 接口描述：省级管理平台应用注册许可查询； b) 接口原型：String queryAppRegisterApply (String jsonMap)； c) 请求参数：见表 3； 表3 参数 许可查询接口请求参数 名称 类型 是否必填 appAdcd 注册的行政区划编码 String 是 appId 应用编码 String 是 appIp 应用 Ip 地址 String 是 appMac 应用所在服务器 Mac String 是 appName 应用名称 String 是 d) 返回参数：见表 4。 表4 参数 值 status 状态 0 成功，1 失败 message 消息 4.2 许可查询接口返回参数 基本信息接口 4.2.1 行政区划查询接口 行政区划查询接口： a) 接口描述：查询省级管理平台上存储的行政区划信息； b) 接口原型：String queryXzqh (String jsonMap)； c) 请求参数：见表 5； 3 DB37/T 3859—2020 表5 参数 行政区划查询接口请求参数 名称 类型 是否必填 appId 注册申请时提交的 appId String 是 updateTime 数据更新时间 String 否 d) 返回参数：见表 6。 表6 行政区划查询接口返回参数 参数 名称 xzqh 行政区划 name 名称 parentId 上级唯一标识 4.2.2 部门信息查询接口 部门信息查询接口： a) 接口描述：查询省级管理平台上存储的部门信息； b) 接口原型：String queryDept (String jsonMap)； c) 请求参数：见表 7； 表7 参数 部门信息查询接口请求参数 名称 类型 是否必填 appId 注册申请时提交的 appId String 是 deptName 部门名称 String 否 deptCode 部门编码 String 否 updateTime 数据更新时间 String 否 d) 返回参数：见表 8。 表8 参数 名称 deptCode 部门编码 deptName 唯一标识 parentId 上级唯一标识 4.2.3 部门信息查询接口返回参数 人员信息查询接口 人员信息查询接口： a) 接口描述：查询省级管理平台上存储的人员信息； b) 接口原型：String queryUserinfo (String jsonMap)； c) 请求参数：见表 9； 4 DB37/T 3859—2020 表9 参数 人员信息查询接口请求参数 名称 类型 是否必填 xzqh 行政区划 String 是 appId 注册申请时提交的 appId String 是 flag 人员身份 10 总河长，11 副总河长， String 否 String 否 12 普通河长，13 河长办，14 河管员 updateTime d) 数据更新时间 返回参数：见表 10。 表10 人员信息查询接口返回参数 参数 名称 userId 唯一标识 name 姓名 loginName 登录名 passWord 登录密码 xzqh 行政区划 cellphone 固定电话 telphone 手机号码 flag 人员身份 10 总河长，11 副总河长，12 普通河长，13 河长办，14 河管员 4.2.4 人员信息变动接口 人员信息变动接口： a) 接口描述：更新省级管理平台上存储的人员信息； b) 接口原型：String userUpdate (String jsonMap)； c) 请求参数：见表 11； 表11 人员信息变动接口请求参数 参数 名称 类型 是否必填 xzqh 行政区划 String 是 appId 注册申请时提交的 appId String 是 userId 唯一标识 String 是 loginName 登录名 String 是 passWord 登录密码 String 否 xzqh 行政区划 String 否 cellphone 固定电话 String 否 telphone 手机号码 String 否 opType 变动类型 1 删除 2 更新 String 是 d) 返回参数：见表 12。 5 DB37/T 3859—2020 表12 人员信息变动接口返回参数 参数 名称 status 状态 0 成功，1 失败 message 消息提示 4.3 河湖数据接