DB37/T 3859-2020 河（湖）长制管理平台数据交换接口

ICS35.240.99

P55

DB37

山东省地方标准

DB37/T3859—2020

河（湖）长制管理平台数据交换接口

Dataexchangeinterfaceofmanagementplatformforriver(lake)chiefsystem

2020-02-25发布2020-03-25实施

山东省市场监督管理局发布

DB37/T3859—2020

目次

前言................................................................................II

1范围..............................................................................1

2术语和定义........................................................................1

3数据交换结构......................................................................1

4数据交换接口......................................................................2

4.1应用注册接口..................................................................2

4.2基本信息接口..................................................................3

4.3河湖数据接口..................................................................6

4.4巡河（湖）数据接口...........................................................11

4.5涉河（湖）事件数据接口.......................................................13

4.6清违整治数据接口.............................................................16

I

DB37/T3859—2020

前言

本标准按照GB/T1.1—2009给出的规则起草。

本标准由山东省水利厅提出、归口并组织实施。

本标准起草单位：山东省水利综合事业服务中心。

本标准主要起草人：张衍福、刘汉刚、葛召华、李红超、王茜、庄磊、李莹、郭伟、王华昌。

本标准为首次发布。

II

DB37/T3859—2020

河（湖）长制管理平台数据交换接口

1范围

本标准规定了河（湖）长制省级管理平台与市级管理平台之间的数据交换接口。

本标准适用于河（湖）长制省级管理平台与市级管理平台之间的数据交换与共享。

2术语和定义

下列术语和定义适用于本文件。

2.1

河（湖）长制river（lake）chiefsystem

由各级党政领导担任河（湖）长，组织领导相应河流（湖泊）管理和保护工作的制度。

2.2

管理平台managementplatform

为河（湖）长制管理工作提供基础信息、河湖巡查、监督管理、河湖治理、考核评价、综合分析等

管理决策与支撑服务的信息系统。

2.3

数据交换dataexchange

各类实体之间相互提供数据的过程。

[GB/T36107—2018，定义3.1]

3数据交换结构

河（湖）长制管理平台数据交换体系结构见图1。

1

DB37/T3859—2020

微信公众号

省级巡河（湖）省级巡河（湖）监督数据监督数据河湖基础信息

数据事件

互联网/VPN/专线

省级管理平台

省级

河湖数据库

互联网/VPN/专线

市级管理平台市级管理平台

市级市级

河湖数据库河湖数据库

互联网/VPN/专线

公众微信号

巡河（湖）数据巡河（湖）事件监督数据事件处理信息清违整治处理

信息

图1河（湖）长制管理平台数据交换体系架构

4数据交换接口

4.1应用注册接口

4.1.1注册申请接口

注册申请接口：

a)接口描述：省级管理平台应用注册申请接口，市级管理平台注册时调用该接口；

b)接口原型：StringappRegisterApply(StringjsonMap)；

c)请求参数：见表1；

表1注册申请接口请求参数

参数名称类型是否必填

appAdcd注册的行政区划编码String是

appId应用编码String是

appName应用名称String是

appIp应用Ip地址String是

2

DB37/T3859—2020

表1注册申请接口请求参数（续）

参数名称类型是否必填

appMac应用所在服务器MacString是

appLinker应用联系人String是

appPhone联系人手机号String是

d)返回参数：见表2。

表2注册申请接口返回参数

参数值

status状态0成功，1失败

message消息

4.1.2许可查询接口

许可查询接口：

a)接口描述：省级管理平台应用注册许可查询；

b)接口原型：StringqueryAppRegisterApply(StringjsonMap)；

c)请求参数：见表3；

表3许可查询接口请求参数

参数名称类型是否必填

appAdcd注册的行政区划编码String是

appId应用编码String是

appIp应用Ip地址String是

appMac应用所在服务器MacString是

appName应用名称String是

d)返回参数：见表4。

表4许可查询接口返回参数

参数值

status状态0成功，1失败

message消息

4.2基本信息接口

4.2.1行政区划查询接口

行政区划查询接口：

a)接口描述：查询省级管理平台上存储的行政区划信息；

b)接口原型：StringqueryXzqh(StringjsonMap)；

c)请求参数：见表5；

3

DB37/T3859—2020

表5行政区划查询接口请求参数

参数名称类型是否必填

appId注册申请时提交的appIdString是

updateTime数据更新时间String否

d)返回参数：见表6。

表6行政区划查询接口返回参数

参数名称

xzqh行政区划

name名称

parentId上级唯一标识

4.2.2部门信息查询接口

部门信息查询接口：

a)接口描述：查询省级管理平台上存储的部门信息；

b)接口原型：StringqueryDept(StringjsonMap)；

c)请求参数：见表7；

表7部门信息查询接口请求参数

参数名称类型是否必填

appId注册申请时提交的appIdString是

deptName部门名称String否

deptCode部门编码String否

updateTime数据更新时间String否

d)返回参数：见表8。

表8部门信息查询接口返回参数

参数名称

deptCode部门编码

deptName唯一标识

parentId上级唯一标识

4.2.3人员信息查询接口

人员信息查询接口：

a)接口描述：查询省级管理平台上存储的人员信息；

b)接口原型：StringqueryUserinfo(StringjsonMap)；

c)请求参数：见表9；

4

DB37/T3859—2020

表9人员信息查询接口请求参数

参数名称类型是否必填

xzqh行政区划String是

appId注册申请时提交的appIdString是

flag人员身份10总河长，11副总河长，String否

12普通河长，13河长办，14河管员

updateTime数据更新时间String否

d)返回参数：见表10。

表10人员信息查询接口返回参数

参数名称

userId唯一标识

name姓名

loginName登录名

passWord登录密码

xzqh行政区划

cellphone固定电话

telphone手机号码

flag人员身份10总河长，11副总河长，12普通河长，13河长办，14河管员

4.2.4人员信息变动接口

人员信息变动接口：

a)接口描述：更新省级管理平台上存储的人员信息；

b)接口原型：StringuserUpdate(StringjsonMap)；

c)请求参数：见表11；

表11人员信息变动接口请求参数

参数名称类型是否必填

xzqh行政区划String是

appId注册申请时提交的appIdString是

userId唯一标识String是

loginName登录名String是

passWord登录密码String否

xzqh行政区划String否

cellphone固定电话String否

telphone手机号码String否

opType变动类型1删除2更新String是

d)返回参数：见表12。

5

DB37/T3859—2020

表12人员信息变动接口返回参数

参数名称

status状态0成功，1失败

message消息提示

4.3河湖数据接口

4.3.1河流基本信息查询接口

河流基本信息查询接口：

a)接口描述：查询省级管理平台上存储的河流信息；

b)接口原型：StringqueryRiver(StringjsonMap)；

c)请求参数：见表13；

表13河流基本信息查询接口请求参数

参数名称类型是否必填

xzqh行政区划String是

appId注册申请时提交的appIdString是

rvcd河流编码String否

rvnm河流名称String否

updateTime数据更新时间String否

d)返回参数：见表14。

表14河流基本信息查询接口返回参数

参数名称

rvcd河流编码

rvnm河流名称

xzcj行政层级1省级，2市级，3县级，4镇级，5村级

length河流长度（km）

lymj流域面积（km2）

ljqy流经区域

bscd流域C海河流域，D黄河流域，E淮河流域

水系CF黑龙港及运东地区诸河水系，CG漳卫河水系，CJ徒骇马颊河水系，D7黄河干流

hncd伊洛河至大汶河水系，DG大汶河水系，D8黄河干流大汶河以下水系，EC沂沭泗河水系，

ED山东半岛诸河水系

4.3.2河段信息查询接口

河段信息查询接口：

a)接口描述：查询省级管理平台上存储的河段信息；

b)接口原型：StringqueryHdxx(StringjsonMap)；

c)请求参数：见表15；

6

DB37/T3859—2020

表15河段信息查询接口请求参数

参数名称类型是否必填

xzqh查询的行政区划String是

appId注册申请时提交的appIdString是

rvcd河流编码String是

hdbm河段编码String否

hdmc河段名称String否

u