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