《电供暖系统技术规范 第10部分：接口》.pdfVIP

ICS XX.XXX CCS XX 中 国 电力 企 业 联 合 会 标 准 T/CECXXXX-2018 电供暖系统技术规范 第10部分：接口 Electrical heating system technical specification Part 10: Interface (征求意见稿) 201X-XX-XX发布 201X-XX-XX实施 中国电力企业联合会 发布 1 I 电供暖系统技术规范 第10部分：接口 1 范围 本部分规定了运营服务平台与监控系统、运营服务平台与第三方平台、监控系统与第三 方平台交互接口的要求、方式、描述、内容与安全等。 本部分适用于电供暖系统接口的设计、开发、实现、验收、运行和维护等。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适 用于本文件。凡是不注日期的引用文件，其最新版本 （包括所有的修改单）适用于本文件。 GB/T 22239—2008 信息安全技术 信息系统安全等级保护基本要求 3 术语和定义 下列术语和定义适用于本文件。 3.1 Web API WebAPI 是网络应用程序接口。包含了广泛的功能，网络应用通过API 接口，可以实现 存储服务、消息服务、计算服务等能力，利用这些能力可以进行开发出强大功能的web 应 用。 3.2 WebService 是一个应用组件，它逻辑性的为其他应用程序提供数据与服务。各应用程序通过网络协 议和规定的一些标准数据格式来访问 WebService，通过 WebService 内部执行得到所需结 果。WebService 可以执行从简单的请求到复杂商务处理的任何功能。 4 接口概述 接口是运营平台或监控系统与第三方平台进行数据交互功能，相关接口关系见图1。接 口包括下列三类： a) 运营服务平台进行数据处理和分析，可以通过接口为第三平台提供数据支撑，完成 不同的业务功能； b) 监控系统也可以直接为第三方平台提供接口进行交互，三方平台通过接口获取电供 暖系统数据，可下发指令至监控系统远程操控设备； c) 运营服务平台不仅可以通过协议从监控系统采集数据，还可以通过接口获取数据及 发送指令给监控系统。 2 图1接口关系 5 接口要求 5.1 一般要求 对于本部分三类接口的设计和开发，应满足下列要求： a) 数据完整性。发送数据时，收发双方必须确保通信数据的完整性，传输失败时能够 进行回滚处理，并记录回滚操作的日志； b) 数据正确性。收发双方要保证所使用的接口协议的一致性，确保使用的是同一接口 协议的相同版本、收发双方具备数据校验码，只有在数据校验码完全正确下，收方 认同数据正确； c) 数据安全性。接口安全应满足GB/T 22239—2008规定的要求； d) 接口扩展性。接口宜随着平台业务的调整而增加或改变传送内容，同时应对修改的 接口协议进行版本管理，且协议双方可以互查对方授权的接口协议内容； e) 通信实时性。对时间有要求的业务，在传输数据时候，应保证传输数据实时性要求， 确保业务的正确开展。 5.2 接口方式 5.2.1 Web API 平台宜提供 WebAPI 接口方式，使用JSON 格式进行数据传递。基本设计原则是对 CRUD 操作使用HTTP 协议对应的方法