1、ICS01.040.13CCS Z0014山西省地方标准DB14/T 28432023生态环境数据 调用服务规范2023-10-10 发布2024-01-10 实施山西省市场监督管理局 发 布DB14/T 28432023I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15管理要求.16调用服务过程.27服务提供.38安全控制.3附录 A（资料性）服务示例.4DB14/T 28432023II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件
2、由山西省生态环境厅、山西省政务信息管理局共同提出，共同监督实施。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省电子政务信息标准化技术委员会归口。本文件起草单位：山西省生态环境监测和应急保障中心（山西省生态环境科学研究院）。本文件主要起草人：卫菊红、曹洁、张補元、高彦、刘建晖、马晓勇、杨毅、郭晓颖、常润东、贺翔宇、贾宁。DB14/T 284320231生态环境数据 调用服务规范1范围本文件规定了生态环境数据调用服务的管理要求、服务过程、服务提供、安全控制。本文件适用于生态环境大数据平台提供的数据调用服务。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文
3、件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB 17859计算机信息系统 安全保护等级划分准则GB/T 5271.1-2000信息技术 词汇 第1部分:基本术语GB/T 35295信息技术 大数据 术语3术语和定义GB/T 35295界定的以及下列术语和定义适用于本文件。数据信息的可再解释的形式化表示，以适用于通信、解释或处理。来源：GB/T 5271.1-2000,01.01.02调用指向存储数据的平台获取数据的行为。生态环境大数据平台指对生态环境数据进行存储、管理和分析，并对外提供生态环境数据调
4、用服务的平台（以下简称平台）。4缩略语下列缩略语适用于本文件。JSON：一种轻量级资料交换格式（JavaScript Object Notation）REST：表述性状态传递（Representational State Transfer）SOAP：简单对象访问协议（Simple Object Access Protocol）Web Service：Web服务，一种跨编程语言、跨操作系统平台的远程调用技术5管理要求DB14/T 284320232平台运维管理部门负责提供数据调用服务。平台运维管理部门负责对服务对象的权限申请进行初审，并推送至数据所属业务管理部门进行审核。业务管理部门负责对所属数
5、据进行最终权限审核。应制定数据调用的服务流程，根据服务对象需求确定数据调用方法。应制定调用服务过程中的身份认证、权限控制、传输加密及异常控制等安全控制措施，确保服务过程数据安全。服务对象应接入电子政务外网，获取生态环境大数据调用服务。6调用服务过程调用服务流程服务对象应注册单独的服务账号，通过平台界面或接口方式申请调用服务，经服务授权，获取数据调用权限，流程及要求如下：服务账号应指定专人使用，不得转借或间接提供给第三方使用；应通过平台申请数据调用权限；平台运维管理部门初审后推送至业务管理部门审核，审核通过后，服务对象通过平台界面或接口调用该数据；调用完成后，服务结束。调用服务操作步骤注册登录后
6、，服务对象进行数据目录查看，对于默认可调用数据，直接调用，对于权限外数据，需申请权限，对于需要平台准备的数据，采用延时服务方式，对于不需要平台准备的数据，采用实时服务方式（见图1）。DB14/T 284320233图 1调用服务操作步骤7服务提供实时服务7.1.1对于数据量较小，不需要平台做复杂运算，能够实时返回的数据可提供实时服务。7.1.2获取权限后，服务对象向平台请求调用数据服务，接到服务请求后，平台立即返回结果给服务对象。7.1.3实时服务示例见附录 A 表 1。延时服务7.2.1对于数据量较大，需要平台分析处理后返回的数据可提供延时服务。7.2.2获取权限后，服务对象向平台请求调用数
7、据服务，平台收到请求，开始准备数据，并告知服务对象已收到请求，在约定时间过后，服务对象再次请求调用数据，获取平台准备好的数据。7.2.3延时服务示例见附录 A 表 2。8安全控制按照 GB 17859 规定采用独立的统一身份认证服务生成用户签名 signature，对登陆的用户进行身份标识和鉴别，用户获取签名后应在规定的时间内使用该签名信息访问相关服务，否则，用户需要重新获取签名。通过权限控制规定服务对象是否能够获取到数据。涉及保密信息的服务要求应使用 HTTPS 或多重加密进行处理，确保数据传输过程安全。在数据调用服务过程中，平台对不同的异常进行响应，如遇到异常，可以和平台运维管理部门联系帮
8、助解决。DB14/T 284320234AA附录A（资料性）服务示例1实时服务示例见表 1。表 1实时服务示例方法名cityAirQualityDaily功能描述调用城市空气质量日数据请求参数codeRegion区域编码startTime开始时间endTime结束时间响应参数status状态码msg信息datacodeRegion区域编码regionName区域名称monitorTime数据时间aqiAQIstatus空气质量primaryPollutant首要污染物pm25PM2.5 浓度（g/m3）ipm25PM2.5 IAQIpm10PM10 浓度（g/m3）ipm10PM10 IAQI
9、co一氧化碳浓度（g/m3）ico一氧化碳 IAQIso2二氧化硫浓度（g/m3）iso2二氧化硫 IAQIno2二氧化氮浓度（g/m3）ino2二氧化氮 IAQIo3臭氧浓度（g/m3）io3臭氧 IAQIDB14/T 2843202352延时服务示例见表 2。表2延时服务示例方法名getAirQualityStationRank功能描述调用站点空气质量实时排名请求参数id服务接收 ID响应参数status0:状态码msg信息data请求成功异步结果status0:状态码msg信息datastationName站点名称stationCode站点编码cityName城市名称codeCode行政区划编码monitortime数据时间aqiAQIstatus空气质量primarypollutant首要污染物rank排名
