EIE4.1D1消息接口协议.doc

EIE消息接口协议
概述
EIE消息接口为企业用户提供了一个可编程的接入接口。使用该协议可以使企业应用系统同企业信息机之间建立基于TCP/IP的连接,企业应用系统使用协议定义的命令可以收发短信。
连接
企业应用系统通过EIE消息接口与企业信息机连接,企业应用系统是客户端,企业信息机作为服务器。客户端主动创建连接,连接一旦建立之后,将一直保持,直到企业端和信息机端主动断开连接或者通讯出现故障。
目前企业信息机默认的消息接口监听端口是7777,在应用时需要参考企业信息机的具体配置。
数据交互模式
企业端同信息机端在连接上的数据交互,使用同步应答模式。即企业端首先发送一个请求数据包,信息机端接收到企业端发送的请求包后,进行内部处理,然后将处理结果打包返回。在这种模式下,企业端的应用在发送请求数据包后,通常应该等待应答数据包返回,不能在应答数据包未返回之前发送新的数据包。
所有的请求和应答数据包均使用文本进行封装。采用类似HTTP协议的格式,即消息头+消息体的格式。消息头通过回车换行两个字符分割成多行,每行表示一个消息参数,消息参数包含参数名和参数值,参数名与参数值使用冒号隔开。消息头以一个空行表示结束。消息体紧跟消息头的空行(注:空行后也需要回车换行字符)。对于带有消息体的消息必须在头部中,使用一个消息参数指定消息体长度参数,这个参数的参数名为Content-Length。
示例如下:
EIE-mand: SubmitSM
Submit-Time: 2004-06-04 10:20:20
Source-Address: 1860
Destination-Address: **********
StateReport-Request: 0
ServiceID-Request: EIE
FeeType-Request: 01
FeeCode-Request: 10
Content-Length: 6
Hello!
企业端应用向信息机发送请求消息到信息机返回应答消息的过程称为会话,会话根据每次发送的请求不同而不同。
目前定义了一些在消息头中通用的参数。列表如下:
EIE-mand:这个参数在所有的请求消息头中都必须定义。它用来表示请求信息机完成什么处理。会话也是通过这个参数来进行分类。目前定义了5个值:SubmitSM、
SubmitSMEX、GetSM、QuerySM、Quit。分别表示发送短信、发送短信(支持帐号密码校验)、接收短信、查询短信、退出接口。
EIE-Proxy-Response:这个参数在所有的应答消息头中都必须定义。它表示请求处理结果的状态。目前定义了两个状态值,一个是OK,表示成功;另一个是Error,表示出错。
Additional-Info:这个参数在应答消息头中可能会使用。它用来保存处理结果的一些额外信息。通常当应答消息的EIE-Proxy-Response参数值为Error时,这个参数将包含出现错误的原因描述。
Content-Length;在所有包含了消息体的消息中都将包含这个参数。它用来定义消息体的长度。企业端应用程序在读完消息头之后(即在Socket缓冲区中读到连续两个回车换行字符串时)。从消息头中读取该参数的参数值,然后继续从Socket缓冲区中读取指定长度的数据