怎样做好江苏省电梯应急处置服务平台数据归集接口规范V1.0.0.docVIP

江苏省电梯应急处置服务平台数据归集接口规范V1.0.0  目录 1. 概述 3 2. 接口概述 3 2.1 定义 3 2.2 通信方式 3 2.3 安全认证 3 3. 数据类型 3 3.1 基本数据类型 3 3.2 符号定义 4 3.3 请求消息结构 4 3.3.1 结构说明 4 3.3.2 元素说明 4 3.3.3 属性说明 5 3.4 响应消息结构 5 3.4.1 结构说明 5 3.4.2 元素说明 5 3.4.3 属性说明 5 3.5 电梯数据更新 6 3.5.1 接口描述 6 3.5.2 请求参数 6 3.5.3 应答参数 7 3.6 工单数据更新 7 3.6.1 接口描述 7 3.6.2 请求参数 7 3.6.3 应答参数 8 3.7 服务代码名称映射 8 3.7.1 请求类型 8 3.7.2 地市编号 8 3.7.3 动作类型 8 3.7.4 故障原因 9 3.7.5 工单响应类型 10 概述 该规范为省局电梯应急数据平台提供给各个地市用于将电梯应急救援系统中的电梯信息、救援信息等电梯困人相关信息归集的数据接口。接口提供的功能包括电梯基本信息、工单信息的上传，更新和删除等。 接口概述 定义 核心接入规范明确各接入系统功能调用必须遵循的请求和响应参数。 通信方式 基于http协议上的Web Service、基于http协议上的RMI。 安全认证 通过webservices报文头中增加加密报文，实现对调用方的安全认证。 数据类型 基本数据类型 序号 类型缩写 类型描述 参考 1 a 字母a－z A、a、ab 2 n 数字0－9 1、12、-1 3 s 特殊字符 @、# 4 an 字母和数字字符 Word2 5 ans 字母、数字和特殊字符 Hell_wold1 6 yyyy 4位数年份 2010（2010年） 7 MM 年份中的月份 03（3月份） 8 DD 月份中的日期 25（25号） 9 hh 小时（24格式） 15（15点） 10 mm 分钟 30（30分） 11 ss 秒 59（59秒） 符号定义 序号 符号缩写 符号性质 符号说明 1 M 强制域(Mandatory) 此域必选，否则将被认为格式出错 2 C 条件域(Conditional) 此域在一定条件下必选 3 O 选用域(Optional) 此域由发送方自选 请求消息结构 结构说明 ?xml version=1.0 encoding=UTF-8? RequestParameter RequestParameter CTRL-INFO REQINFO=01 PROCODE=”32” REGCODE=01 ACTION =01 TIMESTAMP =20131111123212 SESSIONKEY =!@#$%^/ PARAMETERS NODE……/NODE …… /PARAMETERS /RequestParameter 元素说明 序号 元素名称 元素说明 次数 1 RequestParameter 该元素为根元素 1 2 CTRL-INFO 标明本次请求控制信息。属于消息头。 1 3 PARAMETERS 标明本次请求业务参数信息。属于消息体。具体节点名称和节点说明请参考具体的请求接口 1 属性说明 序号 属性名称 属性说明 1 REQINFO 请求类型，参考3.7.1 2 PROCODE 省编号，如江苏是32 3 REGCODE 市县编号，参考3.7.2 4 ACTION 请求动作，参考3.7.3 5 TIMESTAMP 请求动作时间流水，yyyyMMddHHmmss格式 6 SESSIONKEY 会话密钥:MD5加密（REQINFO + REGCODE + ACTION + TIMESTAMP）。 响应消息结构 结构说明 ?xml version=1.0 encoding=UTF-8? ResponseParameter RESPONSE-INFO RESPINFO=01 ACTION =01 TIMESTAMP =20131111123212 / RESPONSECODE000000/RESPONSECODE RESPONSEDESC数据处理成功/ RESPONSEDESC /ResponseParameter 元素说明 序号 元素名称 元素说明 次数 1 ResponseParameter 该元素为根元素 1 2 RESPONSE-INFO 标明本次响应的控制信息。属于消息头。 1 3 RESPONSECODE 标明本次响应业务参数信息。属于消息体。参照3.7 1 4 RESPONSEDESC 对响应代码的说明。 属性说明 序