北京市电力需求侧综合管理服务平台-需求响应接口API说明20150605-2.docx

北京市电力需求侧管理综合服务平台 API说明 PAGE  大唐软件技术股份有限公司 北京市电力需求侧管理综合服务平台 接口API说明 建设单位：北京节能环保中心 编制单位：大唐软件技术股份有限公司 审核单位：北京节能环保中心 编制日期：2015 年 5 月 10 日  目 录  TOC \o 1-3 \h \z \u  HYPERLINK \l _Toc419475085 1 、接口目标与功能  PAGEREF _Toc419475085 \h 3  HYPERLINK \l _Toc419475086 1.1 名词定义  PAGEREF _Toc419475086 \h 3  HYPERLINK \l _Toc419475087 1.2 接口实现目标  PAGEREF _Toc419475087 \h 3  HYPERLINK \l _Toc419475088 1.3 接口功能描述  PAGEREF _Toc419475088 \h 3  HYPERLINK \l _Toc419475089 1.3.1 接口地址  PAGEREF _Toc419475089 \h 3  HYPERLINK \l _Toc419475090 1.3.2 业务流程图  PAGEREF _Toc419475090 \h 3  HYPERLINK \l _Toc419475091 1.4 接口调用实例  PAGEREF _Toc419475091 \h 10  HYPERLINK \l _Toc419475092 1.4.1 通迅流程  PAGEREF _Toc419475092 \h 10  HYPERLINK \l _Toc419475093 1.4.2 实例  PAGEREF _Toc419475093 \h 14  HYPERLINK \l _Toc419475094 1.4.3 数据描述  PAGEREF _Toc419475094 \h 15  HYPERLINK \l _Toc419475095 1.4.4 测点类型  PAGEREF _Toc419475095 \h 15 、接口目标与功能 名词定义 接口实现目标 通过数据交换接口实现各接口对平台的数据上传、负荷经销商获取主动需求响应相关数据。通过这一标准接口实现： 准确的数据交换； 安全的数据交换； 良好的扩展性。 接口功能描述 接口地址 58:8090/bjdsm-ws/services/DataSwitchImp?wsdl 业务流程图 (1). 负荷经销商获取主动需求响应相关数据 客户端 服务端 认证 认证成功,返回publickey 请求获取主动需求响应消息 返回主动需求响应消息 请求获取主动需求响应方案 返回主动需求响应方案 信息反馈 活动图1 (2). 各接口对平台的数???上传 客户端 服务端 认证 认证成功，返回publicKey 传送加密压缩后xml数据 返回处理结果 活动图2 认证 （1）接口功能：对连接用户认证 （2）接口方法：identity (String ak) （3）输入参数ak 请求参数 序号参数名称描述备注1ak　必须输入用户认证密钥应答参数 序号参数类型描述备注1String　返回Xml格式密钥 输出Xml结构说明 序号元素描述备注1resCode输出结果类型标识1：正常 100:异常2publicKey对称密钥用于通讯数据的加密 返回Xml格式实例 序号返回类型描述备注1正常返回系统有新的通知时返回消息的明细drresult rescode1/rescode publickeywww221212121231s/publickey /drresult2异常返回 接口调用过程中出现异常drresult rescode100/rescode errorinfo用户认证错误/errorinfo /drresult 获取数据 方法名称：queryData4Where 方法格式：queryData4Where(String ak,String teName,String whereXml) 请求参数 1.参数描述 序号参数名称描述备注1ak　必须输入用户认证密钥2teName　必须输入表名3whereXml必须输入查询条件应答参数 序号参数类型描述备注1String　返回Xml格式,经密钥加密，GZip压缩 返回Xml格式实例 序号返回