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

ICS35.240.99P55

DB37山 东 省 地 方 标 准DB37/T3859—2020河（湖）长制管理平台数据交换接口Dataexchangeinterfaceofmanagementplatformforriver(lake)chiefsystem20202020022520200325山东省市场监督管理局发布目次目次前言 II范围 1术语和定义 1数据交换结构 1数据交换接口 2应用注册接口 2基本信息接口 3河湖数据接口 6巡河（湖）数据接口 11涉河（湖）事件数据接口 13清违整治数据接口 16前言前言本标准按照GB/T1.1—2009给出的规则起草。本标准起草单位：山东省水利综合事业服务中心。本标准主要起草人：张衍福、刘汉刚、葛召华、李红超、王茜、庄磊、李莹、郭伟、王华昌。本标准为首次发布。河（湖）长制管理平台数据交换接口河（湖）长制管理平台数据交换接口范围本标准规定了河（湖）长制省级管理平台与市级管理平台之间的数据交换接口。本标准适用于河（湖）术语和定义下列术语和定义适用于本文件。2.1河（湖）长制 river（lake）chiefsystem由各级党政领导担任河（湖）长，组织领导相应河流（湖泊）管理和保护工作的制度。2.2（湖管理决策与支撑服务的信息系统。（湖管理决策与支撑服务的信息系统。2.3数据交换 dataexchange各类实体之间相互提供数据的过程。[GB/T36107—2018，定义3.1]3数据交换结构河（湖）长制管理平台数据交换体系结构见图1。市级市级市级省级微信公众号省级巡河（湖）数据省级巡河（湖）事件监督数据监督数据河湖基础信息/VPN/专线省级管理平台/VPN/专线市级管理平台市级管理平台/VPN/专线公众微信号巡河（湖）数据 巡河（湖）事件监督数据事件处理信息清违整治处理信息图1河（湖）长制管理平台数据交换体系架构图1河（湖）长制管理平台数据交换体系架构4数据交换接口应用注册接口注册申请接口注册申请接口：接口描述：省级管理平台应用注册申请接口，市级管理平台注册时调用该接口；接口原型：StringappRegisterApplyStringjsonMap)；1；表1注册申请接口请求参数参数名称类型是否必填appAdcd注册的行政区划编码String是appId应用编码String是appName应用名称String是appIp应用Ip地址String是表1注册申请接口请求参数表1注册申请接口请求参数（续）d)d)返回参数：见表4。表4许可查询接口返回参数基本信息接口行政区划查询接口行政区划查询接口：接口描述：查询省级管理平台上存储的行政区划信息；接口原型：StringqueryXzqhStringjsonMap)；5；参数名称类型是否必填appMac应用所在服务器MacString是appLinker应用联系人String是appPhone联系人手机号String是d)返回参数：见表2。表2注册申请接口返回参数参数值status状态0成功，1失败message消息许可查询接口许可查询接口：接口描述：省级管理平台应用注册许可查询；接口原型：StringqueryAppRegisterApplyStringjsonMap)；3；表3许可查询接口请求参数参数名称类型是否必填appAdcd注册的行政区划编码String是appId应用编码String是appIp应用Ip地址String是appMac应用所在服务器MacString是appName应用名称String是参数值status状态0成功，1失败message消息表5行政区划查询接口请求参数表5行政区划查询接口请求参数参数名称类型是否必填appId注册申请时提交的appIdString是updateTime数据更新时间String否6。表6行政区划查询接口返回参数参数名称xzqh行政区划name名称parentId上级唯一标识部门信息查询接口部门信息查询接口：接口描述：查询省级管理平台上存储的部门信息；接口原型：StringqueryDeptStringjsonMap)；表7部门信息查询接口请求参数d)返回参数：见表8。表8部门信息查询接口返回参数表7部门信息查询接口请求参数d)返回参数：见表8。表8部门信息查询接口返回参数人员信息查询接口人员信息查询接口：接口描述：查询省级管理平台上存储的人员信息；接口原型：StringqueryUserinfo(StringjsonMap)；9；参数名称类型是否必填appId注册申请时提交的appIdString是deptName部门名称String否deptCode部门编码String否updateTime数据更新时间String否参数名称deptCode部门编码deptName唯一标识parentId上级唯一标识表9人员信息查询接口请求参数表9人员信息查询接口请求参数人员信息变动接口人员信息变动接口：人员信息变动接口人员信息变动接口：接口描述：更新省级管理平台上存储的人员信息；接口原型：StringuserUpdateStringjsonMap)；11；表11人员信息变动接口请求参数d)返回参数：见表12。参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是flag人员身份10，1112普通河长，13，14String否updateTime数据更新时间String否10。表10人员信息查询接口返回参数参数名称userId唯一标识name姓名loginName登录名passWord登录密码xzqh行政区划cellphone固定电话telphone手机号码flag人员身份10总河长，11副总河长，12普通河长，13河长办，14河管员参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是userId唯一标识String是loginName登录名String是passWord登录密码String否xzqh行政区划String否cellphone固定电话String否telphone手机号码String否opType变动类型1删除2更新String是表12人员信息变动接口返回参数表12人员信息变动接口返回参数d)返回参数：见表14。d)返回参数：见表14。表14河流基本信息查询接口返回参数河段信息查询接口河段信息查询接口：接口描述：查询省级管理平台上存储的河段信息；接口原型：StringqueryHdxxStringjsonMap)；15；参数名称status状态0成功，1失败message消息提示河湖数据接口河流基本信息查询接口河流基本信息查询接口：接口描述：查询省级管理平台上存储的河流信息；接口原型：StringqueryRiverStringjsonMap)；13；表13河流基本信息查询接口请求参数参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是rvcd河流编码String否rvnm河流名称String否updateTime数据更新时间String否参数名称rvcd河流编码rvnm河流名称xzcj行政层级1省级，2市级，3县级，4镇级，5村级length河流长度（km）lymj流域面积（km2）ljqy流经区域bscd流域C海河流域，D黄河流域，E淮河流域hncd水系CF，CG，CJ，D7，D8，ECED山东半岛诸河水系表15河段信息查询接口请求参数表15河段信息查询接口请求参数湖泊基本信息查询接口湖泊基本信息查询接口：湖泊基本信息查询接口湖泊基本信息查询接口：接口描述：查询省级管理平台上存储的湖泊基本信息；接口原型：StringqueryLakeStringjsonMap)；17；表17湖泊基本信息查询接口请求参数d)返回参数：见表18。参数名称类型是否必填xzqh查询的行政区划String是appId注册申请时提交的appIdString是rvcd河流编码String是hdbm河段编码String否hdmc河段名称String否updateTime数据更新时间String否16。表16河段信息查询接口返回参数参数名称hdbm河段编码hdmc河段名称reaLevel管理级别1省级，2市级，3县级，4镇级，5村级rvcd河流编码kjFlag是否跨界0是，1否kjType跨界类型1左右岸，2上下游，3两者都有bming别名startPos起点所在地endPos终点所在地length管辖长度（km）pjkd平均宽度(m)xzqh行政区划sjhd上级河段编码参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是lkcd湖泊编码String否updateTime数据更新时间String否表18湖泊基本信息查询接口返回参数表18湖泊基本信息查询接口返回参数参数名称lkcd湖泊编码lknm湖泊名称hbjb湖泊级别1省级，2市级，3县级，4镇级，5村级wsar水面面积（km2）capa湖泊容积(万m3)addr湖泊中心位置x湖泊中心位置经度y湖泊中心位置纬度湖片信息查询接口湖片信息查询接口：接口描述：查询省级管理平台上存储的湖片信息；接口原型：StringqueryHpxxStringjsonMap)；19；表19湖片信息查询接口请求参数参数名称类型是否必填xzqh查询的行政区划String是appId注册申请时提交的appIdString是lkcd湖泊编码String是hpbm湖片编码String否hpmc湖片名称String否updateTime数据更新时间String否d)d)返回参数：见表20。表20湖片信息查询接口返回参数参数名称hpbm湖片编码hpmc湖片名称reaLevel管理级别1省级，2市级，3县级，4镇级，5村级lkcd湖泊编码kjFlag是否跨界0是，1否kjType跨界类型1左右岸，2上下游，3两者都有bming别名startPos起点所在地endPos终点所在地startx起点X坐标endx终点X坐标表20湖片信息查询接口返回参数表20湖片信息查询接口返回参数（续）d)d)返回参数：见表22。表22水库基本信息查询接口返回参数库片信息查询接口库片信息查询接口：接口描述：查询省级管理平台上存储的库片信息；参数名称starty起点Y坐标endy终点Y坐标length管辖长度（km）gxmj管辖面积（km2）xzqh行政区划sjhd上级湖片编码水库基本信息查询接口水库基本信息查询接口：接口描述：查询省级管理平台上存储的水库基本信息；接口原型：StringqueryReservoirinfoStringjsonMap)；21；表21水库基本信息查询接口请求参数参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是rescd水库编码String否updateTime数据更新时间String否参数名称rescd水库编码resnm水库名称skjb水库级1省级，2市级，3县级，4镇级，5村级rvcd河流编码restp水库类型1山丘水库，2平原水库tcp水库中心位置经度encl水库中心位置纬度bscd所在流域C海河流域，D黄河流域，E淮河流域hncd所在水系CF，CG，CJ，D7河干流伊洛河至大汶河水系，DG，D8，EC河水系，ED山东半岛诸河水系接口原型：StringqueryKpxxStringjsonMap)；23；表23库片信息查询接口请求参数参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是rescd水库编码String是kpbm库片编码String是kpmc库片名称String否updateTime数据更新时间String否24。公示牌查询接口公示牌查询接口：接口描述：查询省级管理平台上存储的公示牌；公示牌查询接口公示牌查询接口：接口描述：查询省级管理平台上存储的公示牌；接口原型：StringqueryGspStringjsonMap)；25；表25公示牌查询接口请求参数参数名称kpbm库片编码kpmc库片名称rescd水库编码reaLevel管理级别1省级，2市级，3县级，4镇级，5村级kjFlag是否跨界0是，1否bming别名szd水库所在地x水库中心点X坐标y水库中心点Y坐标length管辖岸线长度（m）smmj水面面积（km2）xzqh行政区划sjkd上级库片编码参数名称类型是否必填appId注册申请时提交的appIdString是xzqh行政区划String是code公示牌编码String否巡河（湖）数据接口巡河（湖）数据接口巡河（湖）信息上报接口巡河（湖）信息上报接口：接口描述：巡河（湖）任务结束后，向省级管理平台上报巡河（湖）轨迹数据；接口原型：StringsaveXhTrailStringjsonMap)；表25公示牌查询接口请求参数（续）参数名称类型是否必填name公示牌名称String否updateTime数据更新时间String否d)返回参数：见表26。表26公示牌查询接口返回参数参数名称code公示牌编码name公示牌名称hhlx河湖类型1河流，2湖泊，3水库hhbm河湖编码xzqh行政区划owned所属政府lb类别1省级，2市级，3县级，4镇级，5村级sjhz省级河（湖）长shjhz市级河（湖）长xjhz县级河（湖）长zjhz镇级河（湖）长cjhz村级河（湖）长lxbm联系部门lxr联系人lxdh联系电话photo互联网图片路径，多个图片用英文逗号隔开lgtd经度lttd纬度addr_prov_id省行政区划编码addr_city_id市行政区划编码addr_area_id县行政区划编码addr_town_id镇行政区划编码addr_vill_id村行政区划编码duty河长职责target总体目标year_target年度目标d)返回参数：见表28。d)返回参数：见表28。表28巡河（湖）信息上报接口返回参数巡河（湖）信息查询接口巡河（湖）信息查询接口：接口描述：查询省级管理平台上存储的巡河（湖）信息；接口原型：StringsaveXhTrailStringjsonMap)；29；表29巡河（湖）信息查询接口请求参数27；表27巡河（湖）信息上报接口请求参数参数名称类型是否必填appId注册申请时提交的appIdString是taskId巡河（湖）任务唯一标识String是startTime开始巡河(湖)时间，格式：yyyy-mm-ddhh24:mi:ssString是endTime巡河（湖）结束时间，格式：yyyy-mm-ddhh24:mi:ssString是userId唯一标识String是lgtd经度Double否lttd纬度Double否zongLength巡河（湖）总长度，单位mdouble是zongTime巡河（湖）总时间，单位s，不得少于300秒Long是weather天气情况String否month巡河（湖）月份String是positionList（湖30十秒必须有一个坐标点List是dataTime巡河（湖）时间，格式：yyyy-mm-ddhh24:mi:ssString是photoList图片集合List否参数名称status状态0成功，1失败message消息提示参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是taskId巡河任务唯一标识String否userId唯一标识String否startTime开始巡河（湖）时间，格式：yyyy-mm-ddhh24:mi:ssString否endTime巡河（湖）结束时间，格式：yyyy-mm-ddhh24:mi:ssString否30。表30巡河（湖）信息查询接口返回参数参数名称status状态0成功，1失败startTime开始巡河（湖）时间，格式：yyyy-mm-ddhh24:mi:ssendTime巡河（湖）结束时间，格式：yyyy-mm-ddhh24:mi:ssuserId唯一标识lgtd经度lttd纬度zongLength巡河（湖）总长度，单位mzongTime巡河（湖）总时间，单位s，不得少于300秒weather天气情况month巡河（湖）月份positionList巡河（湖）坐标点集合，不得少于30个坐标点，且每十秒必须有一个坐标点dataTime巡河（湖）时间，格式：yyyy-mm-ddhh24:mi:ssphotoList图片集合涉河（湖）事件数据接口事件上报接口：接口描述：向省级管理平台上报事件信息，包含巡河（湖）事件上报和公众投诉事件；接口原型：StringeventReport事件上报接口：接口描述：向省级管理平台上报事件信息，包含巡河（湖）事件上报和公众投诉事件；接口原型：StringeventReportStringjsonMap)；31；表31事件上报接口请求参数参数名称类型是否必填appId注册申请时提交的appIdString是eventType事件类型String是eventName事件名称String是eventLeavel事件等级1紧急，2不紧急String是reporterId上报人唯一标识String是reportDate上报时间，格式：yyyy-mm-ddhh24:mi:ssString是address上报地址String是lttd纬度Double否lgtd经度Double否eventContent事件内容String否rvcd河（湖）编码String是clfs处理方式1上报，2自行处理，3派发String是taskId巡河（湖）任务唯一标识String否hdbm河（湖）段（片）编码字符串类型String是表31事件上报接口请求参数表31事件上报接口请求参数（续）参数名称类型是否必填cityId市行政区划String是areaId县行政区划String否townId镇行政区划String否eventSource0未处理，1处理中，2已完结，3作废String是handlDate处理时间，格式：yyyy-mm-ddhh24:mi:ssString否status0未处理，1处理中，2已完结，3作废String是opinion意见String否handlPersonId当前处理人唯一标识String是handlPersonTelphone当前处理人手机号码String是zxclr下一步处理人唯一标识String否zxclrTelphone下一步处理人手机号码String否photo互联网图片路径，多个图片用英文逗号隔开String否d)返回参数：见表32。事件查询接口事件查询接口：接口描述：查询省级管理平台上存储的事件信息；事件查询接口事件查询接口：接口描述：查询省级管理平台上存储的事件信息；接口原型：StringqueryEventStringjsonMap)；33；表33事件查询接口请求参数参数名称status状态0成功，1失败eventId事件idmessage消息提示备注事件类型：1，2，3，4，5，6生态环境行为，7，8事件名称：11，12，21，22，317172工业、服务业企业、畜禽养殖场、污水处理设施有异常，81其他参数名称类型是否必填xzqh行政区划String是startTime开始时间，格式：yyyy-mm-ddhh24:mi:ssString否表33事件查询接口请求参数表33事件查询接口请求参数（续）事件下发接口事件下发接口：事件下发接口事件下发接口：接口描述：省级管理平台需要下发到市级管理平台的事件信息；接口原型：StringeventDispatch(StringjsonMap)；35；表35事件下发接口请求参数d)返回参数：见表36。表36事件下发接口返回参数参数名称类型是否必填endTime结束时间，格式：yyyy-mm-ddhh24:mi:ssString否appId注册申请时提交的appIdString是d)返回参数：见表34。表34事件查询接口返回参数参数名称eventType事件类型见4.5.1事件上报备注reporterId上报人唯一标识reportDate上报时间，格式：yyyy-mm-ddhh24:mi:ssaddress河（湖）名称eventContent事件内容hdbm河（湖）段（片）编码status状态0未处理，1处理中，2已完结，3作废handlDate处理时间，格式：yyyy-mm-ddhh24:mi:ssstatus状态0未处理，1处理中，2完结opinion意见handlPersonId当前处理人唯一标识zxclr下一步处理人唯一标识参数名称类型是否必填xzqh行政区划String是startTime开始时间，格式：yyyy-mm-ddhh24:mi:ssString否endTime结束时间，格式：yyyy-mm-ddhh24:mi:ssString否appId注册申请时提交的appIdString是参数名称eventType事件类型见4.5.1事件上报备注reporterId上报人唯一标识表36事件下发接口返回参数表36事件下发接口返回参数（续）参数名称reportDate上报时间，格式：yyyy-mm-ddhh24:mi:ssaddress河（湖）名称eventContent事件内容hdbm河（湖）段（片）编码status状态0未处理，1处理中，2已完结，3作废handlDate处理时间，格式yyyy-mm-ddhh24:mi:ssstatus状态0未处理，1处理中，2完结opinion意见handlPersonId当前处理人唯一标识zxclr下一步处理人唯一标识事件删除接口事件删除接口：接口描述：删除省级管理平台上存储的事件信息；接口原型：StringeventDeleteStringjsonMap)；37；d)返回参数：见表38。表38事件删除接口返回参数d)返回参数：见表38。表38事件删除接口返回参数清违整治数据接口清违整治信息查询接口清违整治信息查询接口：接口描述：查询省级管理平台上存储的清违整治信息；接口原型：StringqueryQwzzStringjsonMap)；39；表39清违整治信息查询接口请求参数参数名称类型是否必填eventId事件唯一标识String是appId注册申请时提交的appIdString是参数名称status状态0成功，1失败message消息提示参数名称类型是否必填xzqh行政区划String是表39清违整治信息查询接口请求参数表39清违整治信息查询接口请求参数（续）清违整治信息上报接口清违整治信息上报接口：清违整治信息上报接口清违整治信息上报接口：接口描述：向省级管理平台上报清违整治信息；接口原型：StringqwzzReportStringjsonMap)；41；参数名称类型是否必填startTime开始时间，格式yyyy-mm-ddhh24:mi:ssString否endTime结束时间，格式yyyy-mm-ddhh24:mi:ssString否appId注册申请时提交的appIdString是40。表40清违整治信息查询接口返回参数参数名称id唯一标识addr位置axcd占用水域岸线长度（m）axmj占用水域岸线面积（m²）lgtd经度lttd纬度rvnm河（湖）名称tbr填报人名称tbrdh填报人电话shr审核人名称tj体积（m3）cityId市行政区划areaId县行政区划townId镇行政区划villId村行政区划wt_descr问题描述zzqzp治理前照片bak备注status状态0未审核，1已提交，2通过审核，3驳回zzhxh问题整治后是否销号1是，0否createtime创建时间，yyyy-mm-ddhh24:mi:ssxh序号czUserid处理人唯一标识status状态0新增，1提交，2修改，3审核通过，4驳回bak备注表41清违整治信息上报接口请求参数表41清违整治信息上报接口请求参数参数名称类型是否必填xzqh行政区划String是appId注册申请时提交的appIdString是addr位置String否axcd占用水域岸线长度（m）Double否axmj占用水域岸线面积（m2）Double否lgtd经度Double否lttd纬度Double否createtime创建时间，格式：yyyy-mm-ddhh24:mi:ssString是rvnm河（湖）名称String否rvcd河（湖）编码String是tbr填报人名称String否tbrdh填报人电话String否shr审核人String否tj3体积（m）Double否zzqzp整治前照片url，多个图片用英文逗号隔开String否bak备注String否hz_zw_xj县级河湖长姓名及职务String否hz_zw_zj镇级河湖长姓名及职务String否hz_zw_cj村级河湖长姓名及职务String否cityId所在市String否areaId所在县String否townId所在镇String否villId所在村String否wt_descr问题描述String