文档介绍：该【电供暖系统技术规范 第10部分：接口 】是由【书籍1243595614】上传分享，文档一共【16】页，该文档可以免费在线阅读，需要了解更多关于【电供暖系统技术规范 第10部分：接口 】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。14中国电力企业联合会发布中国电力企业联合会标准201X-XX-XX实施201X-XX-XX发布电供暖系统技术规范第10部分:接口ElectricalheatingsystemtechnicalspecificationPart10:Interface(征求意见稿)T/CECXXXX-:接口1范围本部分规定了运营服务平台与监控系统、运营服务平台与第三方平台、监控系统与第三方平台交互接口的要求、方式、描述、内容与安全等。本部分适用于电供暖系统接口的设计、开发、实现、验收、运行和维护等。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T22239—2008 信息安全技术信息系统安全等级保护基本要求3术语和定义下列术语和定义适用于本文件。。包含了广泛的功能,网络应用通过API接口,可以实现存储服务、消息服务、计算服务等能力,利用这些能力可以进行开发出强大功能的web应用。,它逻辑性的为其他应用程序提供数据与服务。各应用程序通过网络协议和规定的一些标准数据格式来访问WebService,通过WebService内部执行得到所需结果。WebService可以执行从简单的请求到复杂商务处理的任何功能。4接口概述接口是运营平台或监控系统与第三方平台进行数据交互功能,相关接口关系见图1。接口包括下列三类:运营服务平台进行数据处理和分析,可以通过接口为第三平台提供数据支撑,完成不同的业务功能;监控系统也可以直接为第三方平台提供接口进行交互,三方平台通过接口获取电供暖系统数据,可下发指令至监控系统远程操控设备; 运营服务平台不仅可以通过协议从监控系统采集数据,还可以通过接口获取数据及发送指令给监控系统。,应满足下列要求:数据完整性。发送数据时,收发双方必须确保通信数据的完整性,传输失败时能够进行回滚处理,并记录回滚操作的日志;数据正确性。收发双方要保证所使用的接口协议的一致性,确保使用的是同一接口协议的相同版本、收发双方具备数据校验码,只有在数据校验码完全正确下,收方认同数据正确;数据安全性。接口安全应满足GB/T22239—2008规定的要求;接口扩展性。接口宜随着平台业务的调整而增加或改变传送内容,同时应对修改的接口协议进行版本管理,且协议双方可以互查对方授权的接口协议内容;通信实时性。对时间有要求的业务,在传输数据时候,应保证传输数据实时性要求,确保业务的正确开展。,使用JSON格式进行数据传递。基本设计原则是对CRUD操作使用HTTP协议对应的方法:POST-创建资源GET-检索资源PUT–更新资源-DELETE-删除资源返回值JSON格式: { "message":"OK", "state":1, "code":"", "data":"" }其中,message为消息提示;state为状态,1-成功,0-失败;code为响应代码,详见附录A;data为结果。4在本部分后面的描述中,都以此方式进行阐述。,请求参数与返回值使用XML的方式进行数据传递。,运营服务平台也可以通过接口获取数据、发送指令,分为登陆、获取设备数据列表、获取设备实时数据、获取设备历史数据、远程控制这五大类接口,如图2。图2监控系统与运营服务平台接口图登陆。为防止恶意调用,在运营服务平台进行交互时,首先应进行登陆认证,只有认证通过的平台才能调用接口,详见第7节接口安全;获取设备数据列表。不同类型的设备能采集的数据有所不同,通过此接口,获取指定设备的数据列表,返回值列举了所有能采集的数据项的唯一名称及含义,;获取设备实时数据。通过调用此接口,可获取设备所有数据项的实时状态或值,也可根据数据项名称获取某一数据的实时状态或值,;获取设备历史数据。根据数据项名称、时间段,获取设备某一数据在指定时间段的数据列表,;远程控制设备。监控系统根据需求可提供远程控制设备接口,用于运营服务平台远程调控设备,操作指令应能够进行扩展,。 由于监控系统为第三方平台提供的接口功能与为运营服务平台提供类似,。 第三方平台获取设备的数据可以通过监控系统提供的接口,运营服务平台为第三方平台提供的接口主要为统计相关的接口,分为登陆、运行时间统计、报警时间统计、耗能量统计这四大类接口,如图3。4图3运营服务平台与第三方平台接口图登陆。为防止恶意调用,同样首先要进行登陆认证;运行时间统计。通过此接口,获取设备指定时间段的运行时间统计结果,可按日、月、年进行查询,;报警时间统计。通过此接口,获取设备指定时间段的报警时间统计结果,可按日、月、年进行查询,;耗能量统计。通过此接口,获取设备指定时间段的耗能量统计结果,可按日、月、年进行查询,。,有一个接口需要首先调用,让接口提供方返回密钥,于是就有了登录的概念,过程如图4。图4密钥机制过程图这样只有接口调用方和提供方才知道动态生成的密钥,而且密钥具有时效性,规定为1h,当密钥超时,会判定无效,应重新进行登陆认证。,调用方都需要调用登陆接口进行安全认证。登陆时传入参数:用户名、密码。用户信息应向提供方申请获得。。4(资料性附录)。code含义表序号code值含义10000无异常20001密钥超时30002参数缺失40003参数值格式有误58008未知异常4(资料性附录)。:监控系统IDuserName:用户名password:密码返回值类型application/json返回值描述{ "message":"OK", "state":1, "code":"0000", "data":"KEY值"//密钥值} 。:密钥deviceId:监控系统IDequipmentAdd:设备地址返回值类型application/json返回值描述{ "message":"OK", "state":1, "code":"0000", "data"://数据列表{"voltage":"电压","current":"电流","power":"功率","indoorTemp":"室内温度","outsideTemp":"室外温度",…}}。:获取所有数据实时值,/data/name:根据数据项名称获取Body参数key:密钥deviceId:监控系统IDequipmentAdd:设备地址dataName:数据项名称,根据数据项名称获取时需要返回值类型application/json返回值描述{ "message":"OK", "state":1, "code":"0000", "data"://数据值{"voltage":"220","current":"2","power":"440",…}}。:密钥deviceId:监控系统IDequipmentAdd:设备地址dataName:数据项名称beginTime:开始时间endTime:结束时间返回值类型application/json返回值描述{ "message":"OK","state":1, "code":"0000", "data"://数据值[{"id":1,"value":"220",//值"time":"1502089272000",//时间戳4},{"id":2,"value":"222",//值"time":"1502089272000",//时间戳}...]}。:密钥deviceId:监控系统IDequipmentAdd:设备地址code:操作代码,0010-开关机,可扩展value:1-开机,0-关机返回值类型application/json返回值描述{ "message":"OK", "state":1, "code":"0000", "data":""}。:密钥deviceId:监控系统IDequipmentAdd:设备地址,可选,不选时统计监控系统下所有设备beginTime:开始时间endTime:结束时间period:统计周期,0-日,1-月,2-年返回值类型application/json返回值描述{ "message":"OK","state":1, "code":"0000",4