1、中华人民共和国国家生态环境标准HJ 12942023生态保护红线监管数据互联互通接口技术规范Technical specification for interconnection interface of ecological conservationredline supervision data本电子版为正式标准文本，由生态环境部环境标准研究所审校排版。2023-04-15 发布2023-04-15 实施生态环境部发 布HJ 12942023i目次前言.ii1适用范围.12规范性引用文件.13术语与定义.14缩略语.25总体框架.26数据要求.47接口调用流程.58开发要求.11附录 A（
2、规范性附录）接口名称表.12附录 B（规范性附录）安全验证接口及消息描述.13附录 C（资料性附录）安全验证接口参数示例.15附录 D（规范性附录）结构化数据接口描述.17附录 E（资料性附录）结构化数据接口参数示例.19附录 F（规范性附录）文件接口描述.24附录 G（资料性附录）文件接口参数示例.26附录 H（规范性附录）空间服务信息接口描述.30附录 I（资料性附录）空间服务信息接口参数示例.32附录 J（规范性附录）视频信息接口描述.36附录 K（资料性附录）视频信息接口参数示例.38HJ 12942023ii前言为贯彻落实中华人民共和国环境保护法和生态保护红线生态环境监督办法（试行）
3、，指导和规范生态保护红线监管数据互联互通接口实现方式，促进生态保护红线监管数据的共享和应用，制定本标准。本标准规定了生态保护红线监管数据互联互通总体框架、数据要求、接口调用流程以及开发要求等内容。本标准的附录 A、附录 B、附录 D、附录 F、附录 H、附录 J 为规范性附录，附录 C、附录 E、附录 G、附录 I、附录 K 为资料性附录。本标准为首次发布。本标准由生态环境部自然生态保护司、法规与标准司组织制订。本标准主要起草单位：生态环境部卫星环境应用中心、生态环境部信息中心、内蒙古自治区环境监测总站、江苏省环境监测中心、航天宏图信息技术股份有限公司。本标准生态环境部 2023 年 4 月
4、15 日批准。本标准自 2023 年 4 月 15 日起实施。本标准由生态环境部解释。HJ 129420231生态保护红线监管数据互联互通接口技术规范1适用范围本标准规定了生态保护红线监管数据互联互通的总体框架、数据要求、接口调用流程以及开发要求等。本标准适用于规范和指导国家和省级生态环境部门之间生态保护红线监管数据互联互通的应用程序接口设计、功能研发以及运行管理。县、市级生态环境部门可参照执行。2规范性引用文件本标准引用了下列文件或其中的条款。凡是注明日期的引用文件，仅注日期的版本适用于本标准。凡是未注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。GB/T 22239信息安全技
5、术网络安全等级保护基本要求GB/T 28168信息技术中间件消息中间件技术规范GB/T 28181公共安全视频监控联网系统信息传输、交换、控制技术要求GB/T 32907信息安全技术SM4 分组密码算法HJ 1144生态保护红线监管技术规范台账数据库建设（试行）HJ 1145生态保护红线监管技术规范数据质量控制（试行）HJ 1146生态保护红线监管技术规范平台建设（试行）生态保护红线监管指标体系（试行）（环办生态202029 号）3术语和定义下列术语和定义适用于本标准。3.1生态保护红线台账数据库ecological conservation redline ledger database以生
6、态保护红线台账为核心，包括生态保护红线边界要素、人类活动监管要素、自然生态用地要素、生态服务功能要素、红线管理状况要素、遥感影像要素、基础地理要素、环境质量要素以及系统运行管理等其他要素的规范化数据集。生态保护红线台账以生态保护红线图斑为基本信息单元、以县级行政区为基本管理统计单元。3.2生 态 保 护 红 线 监 管 数 据 互 联 互 通supervision data interconnection of ecologicalconservation redline以生态保护红线台账数据库为基础，通过软硬件系统和接口的配置与研发，以访问接口、汇交填报、实地核实、空间服务等方式，实现国家与
7、地方生态保护红线监管数据的在线交换、及时更新和协同共享。HJ 1294202323.3生态保护红线监管平台supervision platform for ecological conservation redline服务于生态保护红线“面积不减少、性质不改变、功能不降低”管理要求，为实现“一条红线管控重要生态空间”目标而建设的，面向生态保护红线台账管理、人类活动监控、生态系统状况监测、保护成效评估等核心监管需求的业务化平台系统。生态保护红线监管平台建设内容还包括支撑平台运行的计算机支撑环境、一体化监测能力建设等。3.4国家节点national node依托国家生态保护红线监管平台开展全国生态
8、保护红线监管工作的节点。国家节点是各地方节点的根节点。3.5地方节点local node依托地方生态保护红线监管能力开展本行政区生态保护红线监管工作的节点。各地方节点是国家节点的子节点。3.6消息中间件message-oriented middleware基于队列与消息传递技术，在网络环境中为应用系统提供同步或异步、可靠的消息传输的支撑性软件系统。4缩略语下列缩略语适用于本标准。TCP/IPTransmission Control Protocol/Internet Protocol传输控制协议/互联网协议HTTPHyper Text Transfer Protocol超文本传输协议JSONJ
9、avaScript Object NotationJavaScript 对象表示法OGCOpen Geospatial Consortium开放地理空间信息联盟GMLGeography Markup Language地理标记语言5总体框架5.1访问机制以生态保护红线台账数据库为基础，地方节点通过国家生态环境业务专网，访问国家节点接口服务器的网络地址，基于身份安全验证机制，利用消息中间件进行消息传递，实现访问接口的调用和数据交换共享。互联互通接口总体框架见图 1。接口名称见附录 A。HJ 129420233图 1互联互通接口架构图5.2接口功能5.2.1访问授权地方节点通过用户名和密码进行安全验
10、证，获取互联互通接口访问授权。a）国家节点可查看和访问所有地方节点共享的数据；b）地方节点可查看和访问国家节点共享的数据；c）地方节点可查看但不能访问其他地方节点共享的数据。5.2.2数据推送地方节点向国家节点数据库推送生态保护红线监管数据。5.2.3数据提取地方节点从国家节点数据库提取生态保护红线监管数据。5.3接口类型5.3.1安全验证接口用于地方节点访问国家节点时的身份安全验证。5.3.2结构化数据接口用于人类活动监管问题清单、项目审批清单、地面观测信息、红线监管台账等结构化数据的同步更新。HJ 1294202345.3.3文件接口用于生态保护红线划定和调整数据、人类活动监管数据、生态修
11、复数据、自然生态用地数据、植被覆盖度、水源涵养等生态系统服务功能数据以及红线管理制度文件、卫星遥感影像产品等实体数据的在线传输。5.3.4空间服务信息接口用于人类活动遥感监测图斑矢量服务、各类生态功能产品栅格服务、卫星遥感影像服务等空间服务地址及服务信息的在线共享。5.3.5视频信息接口用于监控视频等视频流地址及视频信息的实时共享。6数据要求6.1数据内容以生态保护红线台账数据库为基础，以生态保护红线监管指标体系为核心，以“生态功能不降低、面积不减少、性质不改变”为监管目标，支撑生态保护红线日常监管、年度考核、定期评估业务的数据。主要包括生态保护红线划定和调整、人类活动监管、生态系统服务功能监
12、测、生态保护修复成效评估、生态保护红线管理制度等相关成果数据，最终形成生态保护红线监管全覆盖、动态更新、权威统一的“一个库”“一张网”“一张图”。其中：a）国家节点向地方节点提供疑似生态破坏问题、卫星遥感影像产品、生态参数产品、生态系统服务功能产品、地方报送成果遥感监测和核实反馈等数据；b）地方节点向国家节点提供生态保护红线划定和调整、疑似生态破坏问题核实处理与整改、生态保护修复成效评估、人类活动准入和项目审批、视频监控、地方红线管理等数据。6.2格式要求6.2.1结构化数据结构化数据格式应符合 HJ 1144 中 6.4.2 节的规定。6.2.2文件实体矢量文件采用 SHP、GML 等格式进
13、行交换和共享，栅格文件采用 GeoTIFF、IMG 等格式进行交换和共享。6.2.3空间服务空间服务采用 OGC 标准进行数据共享，支持 WMS、WFS、WCS、WPS、WMTS 等方式发布的地图服务、影像服务或矢量服务。6.2.4流媒体流媒体格式应符合 GB/T 28181 的规定，支持 HTTP Live Streaming 网络传输协议。不同类型数据对应的接口方式见图 2。HJ 129420235图 2不同数据内容与接口方式对应图6.3质量要求数据质量要求应符合 HJ 1145 的规定，并由国家节点自动质检审核。7接口调用流程7.1安全验证接口及消息7.1.1安全验证接口地方节点通过安全
14、验证接口访问国家节点，通过用户名和密码进行身份安全验证，提取令牌信息，实现其他应用程序接口的安全访问。接口参数见附录 B，示例参见附录 C。7.1.2消息采用消息中间件传递消息，消息结构包括消息安全验证、消息队列信息和消息输出内容。消息参数见附录 B。HJ 1294202367.2结构化数据接口7.2.1结构化数据推送接口地方节点向国家节点推送结构化数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问结构化数据推送接口，将结构化数据推送至国家节点数据库；c）通过消息中间件将推送信息通知国家节点。接口调用流程见图 3，接口参数见附录 D，示例参见附录 E。图 3结构化数据推送接口调用流
15、程图7.2.2结构化数据提取接口地方节点从国家节点提取结构化数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问结构化数据提取接口，从国家节点数据库获取所需数据，存储至地方节点数据库；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图 4，接口参数见附录 D，示例参见附录 E。HJ 129420237图 4结构化数据提取接口调用流程图7.3文件接口7.3.1文件推送接口地方节点向国家节点推送数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问文件推送接口，将文件元数据推送至国家节点数据库，将文件实体数据存储至国家节点磁盘阵列；c）通过消息中间件将推送信息通知国家节点
16、。接口调用流程见图 5，接口参数见附录 F，示例参见附录 G。图 5文件推送接口调用流程图HJ 1294202387.3.2文件提取接口地方节点从国家节点提取数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问文件提取接口，将所需文件的元数据保存至地方节点数据库，同时，根据文件元数据信息中的文件下载地址，获取文件实体，并将文件实体存储至地方节点磁盘阵列；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图 6，接口参数见附录 F，示例参见附录 G。图 6文件提取接口调用流程图7.4空间服务信息接口7.4.1空间服务信息注册接口地方节点向国家节点注册空间服务信息时：a）通过安全验
17、证接口获取令牌信息；b）通过令牌信息访问空间服务信息注册接口，将空间服务信息注册至国家节点；c）通过消息中间件将注册信息通知国家节点。接口调用流程见图 7，接口参数见附录 H，示例参见附录 I。HJ 129420239图 7空间服务信息注册接口调用流程图7.4.2空间服务信息提取接口地方节点从国家节点提取空间服务信息时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问空间服务信息提取接口，从国家节点数据库获取所需数据，存储至地方节点数据库；根据获取的空间服务地址，查看空间服务信息；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图 8，接口参数见附录 H，示例参见附录 I。图 8
18、空间服务信息提取接口调用流程图HJ 12942023107.5视频信息接口7.5.1视频信息注册接口地方节点向国家节点注册监控视频信息时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问视频信息注册接口，最后将本地监控视频采集端的视频流地址等信息注册至国家节点；c）通过消息中间件将注册信息通知国家节点。接口调用流程见图 9，接口参数见附录 J，示例参见附录 K。图 9视频信息注册接口调用流程图7.5.2视频信息提取接口地方节点从国家节点提取监控视频信息时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问视频信息提取接口，从国家节点数据库获取所需监控视频采集端的视频流地址等信息，存储
19、至地方节点数据库；根据获取的视频地址，查看监控视频；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图 10，接口参数见附录 J，示例参见附录 K。HJ 1294202311图 10视频信息提取接口调用流程图8开发要求8.1字符集汉字编码采用 UTF-8 字符集。8.2网络通信协议支持 TCP/IP 协议和 HTTP 协议，请求方式为 POST 请求。8.3交换格式采用 JSON 格式进行数据交换。8.4消息机制消息机制应符合 GB/T 28168 的规定。支持消息中间件，具备断点续传功能，用于消息的内容存储、持久化处理及数据库日志记录。8.5数据加密机制数据加密机制应符合 GB/T
20、32907 的规定。密码及数据传输按采用 SM4 分组密码加密方式。8.6网络要求网络安全要求应符合 GB/T 22239 和 HJ 1146 的规定。a）纵向上通过生态环境业务专网实现国家和省级网络环境上下贯通，支撑生态保护红线监管数据的互联互通；b）横向上与本级电子政务网互联互通，支撑本级国土空间规划等数据交换与共享。HJ 1294202312附录A（规范性附录）接口名称表采用安全验证接口、结构化数据接口、文件接口、空间服务信息接口、视频信息接口等方式，通过消息中间件进行消息传递，实现生态保护红线监管数据的信息共享和交换传输。接口描述见表 A.1。表 A.1互联互通接口描述序序号号接接口口
21、类类型型接接口口名名称称接接口口标标识识请请求求方方式式消消息息类类型型1安全验证接口安全验证接口loginServicePOST/2结构化数据接口结构化数据推送接口pushTableDataPOSTTABLE_DATA3结构化数据提取接口getTableDataPOST4文件接口文件推送接口pushFileDataPOSTFILE_DATA5文件提取接口getFileDataPOST6空间服务信息接口空间服务信息注册接口pushGeoServiceDataPOSTGEOSERVICE_DATA7空间服务信息提取接口getGeoServiceDataPOST8视频信息接口视频信息注册接口pus
22、hVideoDataPOSTVIDEO_DATA9视频信息提取接口getVideoDataPOSTHJ 1294202313附录B（规范性附录）安全验证接口及消息描述B.1消息参数消息结构包括消息安全验证、消息队列信息和消息输出内容等内容。消息参数见表 B.1。表 B.1消息参数序序号号参参数数名名称称参参数数标标识识类类参参数数型型说说明明1发送方fromString发送方账号2调用方toString调用方账号3消息通道 IPmsgPathString国家生态保护红线监管平台 IP4消息通道名称msgProvinceQueueCodeString例如：宁夏接收国家生态保护红线监管平台的消息通
23、道名称为“PROVINCE_QUEUE_640000”推送至国家生态保护红线监管平台的消息通道名称为“COUNTRY_QUEUE_640000”5消息的唯一标识msgUniqueString6消息任务类型msgTypeString取值范围：TABLE_DATA：结构化数据FILE_DATA：文件GEOSERVICE_DATA：空间服务信息VIDEO_DATA：视频信息7消息体dataIDsString消息的实际内容B.2安全验证接口安全验证接口功能是为访问国家生态保护红线监管平台应用程序接口提供安全验证信息，防御未授权的用户访问国家生态保护红线监管平台数据。地方用户访问接口时，首先通过用户名和
24、密码获取header token，然后将令牌添加到请求头中访问其他应用程序接口获取或推送数据，否则接口访问失败。安全验证接口参数见表 B.2、B.3 和 B.4。HJ 1294202314表 B.2安全验证接口总体描述项项目目描描述述接口名称安全验证接口接口标识loginService提供方国家生态保护红线监管平台接口地址http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/loginsys/loginService请求参数类型application/x-www-form-urlencoded请求方式POST返回格式JSON包含操作1、通过账号、密码登录获取 token2、令牌有效
25、期为 120 分钟，若 120 分钟内未请求任何接口，则需重新登录表 B.3安全验证接口请求参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1userName账号String在“国家生态保护红线监管平台”中注册的用户名，通过 SM4 加密传输必选2password密码String在“国家生态保护红线监管平台”中注册账号对应的密码，通过 SM4 加密传输必选表 B.4安全验证接口响应参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描
26、述String执行失败、执行成功可选3data详细信息String登录后用户的详细信息必选4headertoken用户 Token 标识String登录后返回的 token 令牌必选HJ 1294202315附录C（资料性附录）安全验证接口参数示例C.1安全验证接口请求参数示例表 C.1安全验证接口请求头描述请请求求头头字字段段值值X-Requested-WithXMLHttpRequestAccept*/*HostIP:端口Content-Typeapplication/x-www-form-urlencoded注：参考“附录 B.2 安全验证接口”，将数据加密后，再调用接口进行传输。表 C
27、.2安全验证接口请求体描述登登录录接接口口请请求求体体请求地址:http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/loginsys/loginServiceuserName:6db65a59778ab50dda183294852cfccd,SM4 加密后的账号password:06b960b7693ae232efeee6f02812033fSM4 加密后的密码C.2安全验证接口响应参数示例表 C.3安全验证接口响应头描述响响应应头头字字段段值值headertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Access-Control-A
28、llow-CredentialstrueAccess-Control-Allow-methodsPOST,OPTIONSAccess-Control-Allow-Origin*注：成功登录后，将后台生成的 token 返回至 response Headers 或 response Body 中。HJ 1294202316表 C.4安全验证接口响应体描述响响应应体体data:userName:青海省,roleName:省,headertoken:c9f9bc90faf24c518063b33e9c6859ecHJ 1294202317附录D（规范性附录）结构化数据接口描述D.1结构化数据推送接口
29、结构化数据推送接口功能是实现地方节点向国家节点推送并更新二维表等结构化数据的能力。结构化数据推送接口参数见表 D.1、D.2 和 D.3。表 D.1结构化数据推送接口总体描述项项目目描描述述接口名称结构化数据推送接口接口标识pushTableData提供方国家生态保护红线监管平台接口地址http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/newHxtz/pushTableData推送消息类型TABLE_DATA请求参数类型application/json请求方式POST返回格式JSON包含操作1、将 token 信息放入请求头中的 header token 中2、调用接口，推送并
30、更新结构化数据3、将消息信息发送给国家节点表 D.2结构化数据推送接口请求参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1tableDataList结构化数据列表String结构化数据列表参考 HJ 1144必选2tableDataType结构化数据类型String结构化数据类型参考 HJ 1144必选表 D.3结构化数据推送接口响应参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选D.2结构
31、化数据提取接口结构化数据提取接口功能是实现地方节点从国家节点提取二维表等结构化数据的能力。结构化数据提取接口参数见表 D.4、D.5 和 D.6。HJ 1294202318表 D.4结构化数据提取接口总体描述项项目目描描述述接口名称结构化数据提取接口接口标识getTableData提供方国家生态保护红线监管平台接口地址http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/newHxtz/getTableData接收消息类型TABLE_DATA请求参数类型application/x-www-form-urlencoded请求方式POST返回格式JSON包含操作1、将 token 信息
32、放入请求头中的 header token 中2、调用接口，提取更新的结构化数据3、将消息信息发送给国家节点表 D.5结构化数据提取接口请求参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1tableDataList结构化数据类型String结构化数据标识必选2code行政区代码String行政区代码必选3year结构化数据年份String年份集合用逗号分隔可选表 D.6结构化数据提取接口响应参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1status执行状态标识Int0（失败）、1（成功）必选2msg
33、执行状态描述String执行失败、执行成功可选3data详情信息String数据提取结构参考 E.2.3必选HJ 1294202319附录E（资料性附录）结构化数据接口参数示例E.1结构化数据推送接口示例E.1.1结构化数据推送消息示例表 E.1结构化数据推送消息描述完完成成数数据据入入库库后后，推推送送至至国国家家生生态态保保护护红红线线监监管管平平台台 ActiveMQ 消消息息示示例例msgUnique=7cf2a4775d2246de8e81f692681656eb,消息唯一标识msgType=TABLE_DATA,业务类型标识dataMsgs=消息描述data:项目审批数据,执行成功
34、,共入库 1 条数据,dataNums=1,推送数据个数userName=新疆维吾尔族自治区,行政区名称code=650000,行政区代码pushtime=2020-08-07 13:00:00,推送时间status=1执行状态：0 失败，1 成功E.1.2结构化数据推送接口请求参数示例表 E.2结构化数据推送请求头描述请请求求头头字字段段值值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-ali
35、veContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin*HJ 1294202320表 E.3结构化数据推送请求体描述结结构构化化数数据据推推送送请请求求体体请求地址：http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/newHxtz/pushTableDatatableDataType:HXMJTZ,结构化数据类型编码tableDataList:数据集合
36、code:650000,行政区代码year:2020,台账年份allInfo:LYGTMJKM2:6668.59,LYHXMJKM2:856.17,LYHXMJZB:0.12838845992931,LYHXTBSLG:7,HXMC:喀什噶尔河-叶尔羌河流域防风固沙生态保护红线区,HXLX:防风固沙,STXTYZBLXLD:,BZ:该条记录 JSON 数据E.1.3结构化数据推送接口响应参数示例表 E.4结构化数据推送响应头描述响响应应头头字字段段值值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-method
37、sPOSTAccess-Control-Allow-Origin*Content-Typeapplication/json;charset=UTF-8表 E.5结构化数据推送响应体描述结结构构化化数数据据推推送送响响应应参参数数msg:执行成功,共入库 1 条数据,消息描述status:1执行状态E.2结构化数据提取接口示例E.2.1结构化数据提取消息示例HJ 1294202321表 E.6结构化数据提取消息描述接接收收国国家家生生态态保保护护红红线线监监管管平平台台 ActiveMQ 消消息息msgUnique=7cf2a4775d2246de8e81f692681656eb,消息 IDms
38、gType=TABLE_DATA,消息类型dataMsgs=code:LYHXTZ数据编码year:2020,2021数据年份,pushtime=2020-08-07 13:00:00,推送数据时间status=1执行状态：0 失败，1 成功E.2.2结构化数据提取接口请求参数示例表 E.7结构化数据提取请求头描述请请求求头头字字段段值值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Connectionkeep-aliveContent-Typeapplication/x-ww
39、w-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin*表 E.8结构化数据提取请求体描述结结构构化化数数据据提提取取请请求求体体请求地址：http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/newHxtz/getTableDatapageNo:1,页数pageSize:500,每页条数code:110000,行政区代码tzCode:LYHXTZ,数据编码year:2020,2021台账年份E.2.3结构化数据提
40、取接口响应参数示例HJ 1294202322表 E.9结构化数据提取响应头描述响响应应头头字字段段值值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin*Content-Typeapplication/json;charset=UTF-8表 E.10结构化数据提取响应体描述结结构构化化数数据据提提取取响响应应体体msg:执行成功,data:数据体lastPage:1,最后一页navigatepageNums:1,页数pageSize:2,
41、每页个数pageNum:1,当前页数total:2,数据总个数pages:1,总页数firstPage:1,开始页数size:500,每页个数（每页最大取 500 条）list:数据集合allInfo:XZQYBZYQMJM2:1643976000,XZQZYQMJM2:2027729700,XZQJZYQMJM2:7141567500,HXNYBZYQMJM2:,HXNZYQMJM2:,HXNJZYQMJM2:,该条记录 JSON 字符串code:110000,行政区代码createTime:2020-12-28T18:38:55,数据创建时间province:北京市,city:北京市,ye
42、ar:2015,数据年份tzCode:LYHXTZ,数据编码updateTime:2020-12-28T18:38:55,更新时间id:684ef0f33c9647369f631707b2c9355a,唯一标识,allInfo:XZQYBZYQMJM2:12147254100,XZQZYQMJM2:1789541100,XZQJZYQMJM2:2145787200,HXNYBZYQMJM2:,HXNZYQMJM2:,HXNJZYQMJM2:,code:110000,createTime:2021-01-19T11:38:11,province:北京市,city:北京市,HJ 129420232
43、3续表结结构构化化数数据据提提取取响响应应体体year:2015,tzCode:LYHXTZ,updateTime:2021-01-19T11:38:11,id:cbc3a5761f974e7bb92753d3e7353d47,status:1HJ 1294202324附录F（规范性附录）文件接口描述F.1文件推送接口文件推送接口功能是实现地方节点向国家节点推送文件数据的能力。文件推送接口参数见表 F.1、F.2 和 F.3。表 F.1文件推送接口总体描述项项目目描描述述接口名称文件推送接口接口标识pushFileData提供方国家生态保护红线监管平台接口地址http:/国家生态保护红线监管平
44、台 IP:端口/hlhtAPP/ArcSyncHttpDownload/pushFileData推送消息类型FILE_DATA请求参数类型application/json请求方式POST返回格式JSON包含操作1、将 token 信息放入请求头中的 header token 中2、调用文件推送接口，向国家生态保护红线监管平台推送文件3、将消息信息发送给国家节点表 F.2文件推送接口请求参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1code行政区代码String行政区代码必选2file文件MultipartFile条件查询参数文件流必选表 F.3
45、文件推送接口响应参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选F.2文件提取接口文件提取接口功能是实现地方节点从国家节点提取文件数据的能力。文件提取接口参数见表 F.4、F.5 和 F.6。HJ 1294202325表 F.4文件提取接口总体描述项项目目描描述述接口名称文件提取接口接口标识getFileData提供方国家生态保护红线监管平台接口地址http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/proDownLoadi
46、ng/getFileData接收消息类型FILE_DATA请求参数类型application/json请求方式POST返回格式JSON包含操作1、将 token 信息放入请求头中的 header token 中2、调用接口，获取文件数据 ID 及下载地址3、根据下载地址，下载数据4、将消息信息发送给国家节点表 F.5文件提取接口请求参数序序号号参参数数标标识识参参数数名名称称参参数数类类型型参参数数说说明明必必选选/可可选选1pageNo当前页数Int页码必选2pageSize显示条数Int页个数最大 500必选3orderId任务名称String条件查询参数可选表 F.6文件提取接口响应参数
47、1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选3list文件列表String一个 list 中可以包含多个文件元信息必选HJ 1294202326附录G（资料性附录）文件接口参数示例G.1文件推送接口示例G.1.1文件推送消息示例表 G.1文件推送消息示例描述完完成成数数据据入入库库后后，推推送送至至国国家家生生态态保保护护红红线线监监管管平平台台 ActiveMQ 消消息息示示例例msgUnique=7cf2a4775d2246de8e81f692681656eb,消息唯一标识msgType=FILE_DATA,文件类型标识d
48、ataMsgs=data:执行成功,上传成功 1 个文件消息描述,dataNums=1,推送数据个数userName=宁夏回族自治区,行政区名称code=640000,行政区代码pushtime=2020-08-07 13:00:00,推送数据时间status=1执行状态：0 失败，1 成功G.1.2文件推送接口请求参数示例表 G.2文件推送请求头描述请请求求头头字字段段值值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateCo
49、nnectionkeep-aliveContent-Typemultipart/form-dataAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin*HJ 1294202327表 G.3文件推送请求体描述文文件件推推送送请请求求体体请求地址：http:/国家生态保护红线监管平台 IP:端口/hlhtAPP/ArcSyncHttpDownload/pushFileDatacode:640000,行政区代码file:file文件实体G.1.3文件推送接口响应参
50、数示例表 G.4文件推送响应头描述响响应应头头字字段段值值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin*Content-Typeapplication/json;charset=UTF-8表 G.5文件推送响应体描述文文件件推推送送响响应应体体msg:执行成功,上传 1 个文件,消息描述status:1执行状态G.2文件提取接口示例G.2.1文件提取消息示例表 G.6文件提取消息示例描述接接收收国国家家生生态态保保护护红红线线监监管
