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