1.1.1.1 接口数据有两种形式:
设置格式[聂卫红]:
项目符号和编号
通讯协议采用 TCP/IP 标准协议,客服系统中的业务功能作为 Client 向 Server 发送请求,
Server 为运行于营业系统的应用程序,用于实时监听客服系统的业务请求并作出响应,根
据请求包头中的业务类型代码,访问不同业务系统的数据 DB,提供客服系统所需的数据。
服务器必须支持并发处理.
客户端不做负载控制,负载控制由服务器端负责。
接口数据有两种形式:
请求包
由 Client 端发出业务请求,以请求包的形式传送至服务端,其中包括该项业务所需要的
参数信息.
应答包
服务端处理相应的业务请求并以应答包的形式返回数据。
数据包由包头和包体构成,包头内容主要包括各种数据包的共同的基本信息,包体内容
主要包括各种数据包的特有信息.
包结构示意图
注: Ax 为包头的组成元素。
B 为包体。
1.2 包头定义
包头数据内容为一定长 ASCII 字符串(86 位),如果每项实际长度不足时,后补空格
(0X20),具体内容如下:
A0 版本号信息(2 位):标识当前使用的协议版本号。如 1.0,1.1。
A1 数据包大小(5 位):以字节为单位,不足补空格。如大小为 256 个 bytes,应为:
256__。
设置格式[聂卫红]:
项目符号和编号
A2 流水号(20 位):业务流水号,标志每笔具体交易。数据校验包可无流水号.
A3 标志(1 位):1 表示成功 0 表示失败,仅适用于响应包。
A4 服务类型(12 位):编码规则参见《中国联通客服中心 H2 接口编码规则》。(编
号不对)
A5 业务号码(20 位):移动电话号码、IP Phone 帐号、市话电话号码、长话帐号、
寻呼号、165 帐号。当业务号码包括多个子号时,子号之间必须以分隔符“-”分隔。
如电话号码(01087654321)由区号(010)和电话号(87654321)组成时,业务号
码为“010-87654321”。
A6 业务号码类型(1 位):1 电话号码;2 帐号;3 其他。
A7 营业点 (6 位): 业务受理地点。
A8 营业员 (8 位): 业务受理人。
A9 包编号(5 位):标志该笔流水的第几包数据。
A10 最后一包标志(1 位):在进行多包发送的情况下,该标志用以标明是否为最后
一数据包。
1 最后一包数据,无后续包;
0 非最后一包数据,有后续包,连接错误,I/O 错误等;
A11 错误码(5 位):在标志为失败时需检查该错误码。错误码包括系统操作错误
和业务处理错误。
1.3 包体定义
一个数据包总长度不可大于 20k。
对于包体,各个字段可变长,字段之间使用分割符。每字段之间用“TAB 键 0x09”分隔,
每记录之间用“回车键 0x0d,0x0a”分隔,包结束用“0x1a”。 无包体的包也有包结束符。
包结束符算在包长度中。每个字段后面都需要加字段分隔符,同样,每个记录后面都增加记
录分割符。
对存在多条返回记录的业务,一数据包可含多条记录。长度如超过 20K,应以多包数据
发送,截包位置限制在记录的分隔符“回车键 0x0d,0x0a”之后,即一条记录的数据不允许
存在两个包中。
设置格式[聂卫红]:
项目符号和编号
删除[聂卫红]:
对存在多条返回记录的业务,一数据包可含
多条记录。长度如超过 20K,应以多包数据发送,截包位
置不限制。
删除[聂卫红]:
删除[聂卫红]:
割符。
对于包体,各个字段可变长,字段之间使用分
设置格式[聂卫红]:
项目符号和编号
对于不同的服务类型,其请求包和应答包的包体具有不同的内容。
1.4 错误编码
错误编码 00000-00499 为固定编码,不做变动,错误代码表也存在。
错误编码 00500-99999 为非固定编码,需通过错误代码表提取错误信息。
固定编码中 00400-00499 为系统错误。如网络连接错误,I/O 错误等。
下面是常见的错误:
错误信息
错误编码
用户档案不存在
密码错误
无该月帐单信息
无该月话单信息
此项特服暂未开通
查找不到相应的实时话费
结算帐号不存在
查找不到用户基本信息
用户已经处于开机状态
用户已经处于停机状态
用户已销户,无法开机
用户属欠费用户
通话级别与原来相同
漫游级别与原来相同
客户无法开通此项特服
非本地用户
00101
00102
00103
00104
00105
00106
00107
00108
00109
00110
00111
00112
00113
00114
00115
00116
系统错误(网络连接错误、网络连接超
00400-00499
时)
说明:接口必须处理各种错误,在此对业务类型的错误处理方式不做规定。但对系统错
误作出处理规定,当发生系统错误时,连续发送 3 次连接请求,如不成功提示告警信息。