生态环境分区管控信息平台接口规范（征求意见稿）.docx

《生态环境分区管控信息平台接口规范（征求意见稿）.docx》由会员分享，可在线阅读，更多相关《生态环境分区管控信息平台接口规范（征求意见稿）.docx（30页珍藏版）》请在优知文库上搜索。

1、附件4HJ中华人民共和国国家生态环境标准HJ20生态环境分区管控信息平台接口规范Interfacespecificationforeco-environmenta1.zoningmanagementp1.atform（征求意见稿）20-实施20-发布生态环境部发布目次前iiI适用范国I2烷枢性引用文件13术语和定义I4缩略语25设计股则26基本要求37接口类型与内容48接D使用模式与使用要求15附录A（资料性附录接口规范示例17前言为提砌g中共中央国务院关于深入打好污染防治攻坚战的意见中共中央分公厅国务院办公厅关于加强生态环境分区管外的意见要求.指导生态环境分区管控信&平台建设.制定本标准.本

2、标准规建了生态环境分区管控信息平台接口的设计傀则、基本要求、类粗与内容、应用模式和使用要求,为生态环境分区代控信息平台接11开发和应用提供规范指导.本标席为首次发布.本标准由生态环境部环境影响评价和排放管理司、法堤与标准司、办公厅出织制订.本标准的附录A为费料性附录，本标准主要起草单位：由生态环境部环境匚程评估中心牵头.组织相关技术m位共同起草.本标准生态环境部20口年月日批准，本标准自20口年OQ月H起实施.本标准由生态环境部解择，生态环境分区管控信息平台接口规范1适用范围本标准规定了生态环境分又管IS信息平台接口的设计原则、基本要求、类型与内容、应用模式和使用要求。本标准适用于国家与地方生

3、态环境分区管控平台的应用程序接口的设计与建设,以指导生态环境分区管控相关业务数据的在现交换、互操作与协同共享,生态环境分区管控信息平台与其他业务管理及政务服务平台接口开发可照木标准执行。2规范性引用文件本标准引用了下列文件或其中的条款.凡是注明日期的引用文件,仅注日期的版本适用于本标准-凡是未注日期的引刖文件,其用新版本（包括所有的修改单）适用于本标准。GBT222392019信息安全技术一网络安全尊姒保护基本要求GBT30169地理信息葩于网络的要素瞅务GB,T35652瓦片地图服务H1.T416环境信息术谱HJ719-2014环境信息系统数据阵访间接1规范HJ729-2014环境信息系统安

4、全技术规范OGC04094OpcnG1.SWcbRaturcScniccImp1.ementationSPCCifiCatiOnOGC06042OpcnGISWebMapSerViCeIinp1.ernen1.a1.iunSpecifku1.ionOGC07057OpenGISWebM叩Ti1.eServiceImpIeinentmiiMiStandard三线取”成果数据规范（试行）环办环评（2018）18号）3术语和定义HJZT416界定的以及下列术谪和定义适用于本标准.3. 1生态环境分区管控eco-environmenta1.zoningmanagement以保际生态功能和改善环境侦量为

5、目标,实施分区域差坪化管控的环境管理出度.3.2生态环境分区管控信息平台eco-environmenta1.zoningmanagementp1.atform面向生态环境分区管控管理和应用需求，实现生态环境分区管控成果等数据的汇交、管理、共享及生态环境分区管控应用的软硬件系统,3.3接口interface侑息系统为其他使用方提供数据交换的一种方式，是由一系列功能封装后可被信史系统用户直接远程调用的软件接口。3.4安全毅证接口securityverificationinterface用户身份蛤证的应用开发规范性约定，用于安全访问生态环境分区管控信息平台提供的相关数据接口.3.5站构化数据接口st

6、ructureddatainterface根据关犍字、空间位置等条件改取牛态环境分区管控成果数据的列表清单、管投整求以及统计分析等结构化数据的应用开发煨范性约出.3.6文件推送接口1epushinter1.ace推送生态环境分区管控成果文件、支揖文件以及文件元数据信息的应用开发规范性内定.3.7空间地图服务接口spatia1.mapserviceinter1.ace提佻生.态环境分I又管控成果数据等相关地图服务访问的应用开发规范性约定.4缩珞诘下列缩略语适用于本标准.WFS：M络密索取务WMSt网络地图眼务(WcbMapScrvicc)WMTS：网络地图切片服务现范(WebMapTiIeSer

7、vice)JSON：JavaScripi内型龙示法UR1.：统一资源定位零(UniformResource1.ocator)UTF-8：以字节为单位针对Unicode可变长度的字符编码UnicodeTransformationFornw1.8-bi1.)SMI：SMI分If1.密码算法(SMIcryptographica1.gorithm)VPN：虚拟专用网络(VirtUa1.PriYateNe1.WOrk)HTTP：用文本传输例议(HyPerteX【TransferPrmsoOXM1.；可扩展标记语(Extensib1.eMarkup1.anguage)5设计原则1.1 规范性生态环境分区管

8、控信息平台接口应在接口命名、字符摒码、文本描述,数据交换格式等方面保林统-ft保生态环境分区管控信息平台接I可查找，可访问.可现制及可可操作。1.2 完整性生态环境分区首控信息平台接口必家保证业务操作的原子性，以确保数据的完整性和致性.1.3 安全性生态环境分区管控信息平台接口的保证传输对象的信息做私,宜对传输对望采用转换加密或验证等方式进行传输，生态环境分区管控信息平台接口应提供接口调用的日志记录，隔保生态环境分区管控信息各类操作可视源和监控.1.4 可扩展性生态环境分区管控倍息平台接IJ可根据业务和技术发展需求,进行接I及其功能的扩展.按U扩展时，应保持接口间的兼容性与一致性“6基本要求6

9、. 1规范性翦本要求a）按U名称应准确在达接U功能,应使用驼砰命名法,应采用UTF-8字符集：b按1.1.状态码应迸循表1：O协议消息应使用JSON格式迸行数据交换.表1接口状态码状态码晚明2400HTTP请求成功,返网的JSON数Itt赴幽史继客户端请求无效,例如请求参数带课401未通过平台眼务州（认证403讲求无权限404找不到谙求的路符或者请求的对&不存在VI1.T1.I6.1 完整性基本要求生态环境分区管控信息平台的各类接口都应该只完成一类数据处理，保证接口的易读性、易用性和数据操作处理的原子性，6.2 安全慢基本要求生态环境分区管控信息平台接口安全性应涵足接口谙求方式、接口蹿用安全性

10、、眼感数据安全性的要求。a）接口请求方式接口应支持InTPK1.文本传输通信t议,安全监证接口、结构化数据接口、文件推送接口都应采用POST方式iff求：空间地图服务接11按照规苞兼容性可果用GET诂求，b）接口调用安全性接口调用必须提供访问令牌，用标识接口调用者的身价无证，减少用户名和率码的传粕次数，J1.令牌雷要设置Yf效时限,接口提供者需要根据调用者的用户名和加密的密码/证调用者的身份权限,同时生成访问令牌.C）坡镇数据安全性应针对股监数据进行脱粒处理,调用安全验证接11时传入的密码信息应采用不怔于SMI等级的加密技术进行传输,在服务沏针对加密的用户宏码进行解析以隔“谓用接口用户身份信息

11、.6.3 4可追溯性基本要求生态环境分区管控信息平台接”提供方和接I调用方都应该记录接I请求的口志，便于快速定位弁常请求位置和推杳接口同趣.以及为后续共享服务接1.Ii1.ij用的监控和统计提供数据支撑.7接口类生与内容71接口类型生态环境分区管控侑息平台接口分为四类，包括：安全验证接U、结构化数据按U,文件推送接I和空间地图服务接口。平台可根据实际情况提供相应类别的接口,6.4 接口组成接口由四部分级成：接口地址、谙求畲数、请求方式、响应参数。其中,接口地址应包含接口的版本标见（如、1）,请求参数应定义接口访问的输入参数及参效类55.请求方式应定义访问接I获收或提交数据的方式.响陶参数应包含

12、接口阴应的状态64和返回数据的组织结构,状态码反映接口调用的病应状态,一个接口可以有一个或多个参数，每个参数需明确为必选或可选。6.5 接口内容7.3. 1安全验证接口安全险证接口用于结构化数据接口、文件推送接口、空间堆图服务接口调用的身份安全脱证，通过用户名和密码获取加密字符串令牌（Wken）,实现应用程序接11的安全访问.安全验证接口用于生成用户身份的底的token,以及返I可区分不同用户身份的凭证appKey.以实现各类应用程序接口的安全访问。具体内容包含接口总体描述、接口请求参数说明和响应与数说明见表2表4,接口示例卷见附录A.1。表2安全验证接口总体描述接口名称安全验证接口接口地址M

13、tpMB务SIRecvhapivI/AuthScrviccrtogin请求卷数类不叩P1.iemiMjSan追求方式POST物应参数类型JSON接口描述I.通过IK号和加密密码。录佚取IOkm和用户相X处2、令牌仃效期为120分林.并120分林内未请求任何接口.则;，重新登求3安全蕤证接口请求参数说明序当参攻标识卷数名祢必出可选多攻类型参数说明1UMrrNaine用户账号必选字符型训用方的用户名2pcvsWord密田必选字符型盟用方注幽长“对吨的密码通过加澎传输表4安全险证接口响应叁数说明字号警致标识叁数名称必选何逸叁效类型参数说明Icode执行状态标识必选字符型HTTP请求的状态码2msg执

14、行状态描述必选字符型返回搭迷3IhhI用户信息必选字符型用户的身份僧息4tokenIII/token标识选字符型会业后迄问的“km令网7. 3.2结构化数推接口结构化数据接口主要用于获取生态环境分区管控成果数据相关的行询结果.如生态环境分区管掖成果数据的列表清单、管控要求详情等结构化致据,应至少包括狭取分区管控成果数据列表接口、根抠编码宜询管控要求详情接1、根据空间位置15询管控要求详情接1,且可根据应用需求扩展，用于获取分类统计分析等就构化数据.按照HJ719-2014中应用服务接口方式规定为用户提供应用服务接口访问生态环境分区管控信息平台的相关数据。7. 3.2.1获取生态环境分区管控成果数据列表接口获取生态环境分区管持成果数据列衣接口总体描述、获取分区管拴成果数据列登接口请求参数说明.荻收分区管控成果数据列表接1.1.响应参数说明见表5表7,接口示例参见附求A2表5获取生态环境分区管控成果数据列表接口总体描述接口名称伏址生态环境分区曾控成果敢粼列我接口接口地址http3i务器IP:端Ieco,apivIgXydQUCryShMe/GcmcGkdyHj户ByCnditionSharc?KpPKCy;调用方；IPPKCy请求参