CTI服务接口协议.pdf

CTI CTI CCTTII系统协议接口 备注:::: 在响应包发送之前，会给客户端回送一个临时响应包 包的定义如下： ?xml version=1.0encoding=UTF-8? responseid=100000 type=trying req_typemake_call/req_type /response 一：协议包 简要描述： DLL 与CTIServer之间的连接通过TCP 完成，为了确保包的安全可靠性，避免TCP 流 传输的时候收到不完整包，粘包等情况的发生，在发送的每一个包前都添加了包头： 包头为二进制格式： 包头（1字节） 保留字段（1字节） 长度（2字节） 包头：03 包头字段： 第三字节：长度高8位 第四字节：长度低8位 二：定时器处理机制 简要描述： DLL 内部为每一个请求包都设置了定时器处理： （1）DLL 发送请求给CTIServer，在规定的时间内没有收到该请求的响应时，DLL 会自动 生成一个失败的响应告诉客户端，并清除该定时器； （2）DLL 发送请求给CTIServer，在规定的时间内收到CTIServer 的失败响应，将该响应回 送给客户端，并清除该定时器； （3）DLL 发送请求给CTIServer，在规定的时间内收到CTIServer 的成功响应，将该响应回 送给客户端，并清除该定时器； 每个请求包的具体定时器时长，请详细见各个协议包； 三：话机状态 dev_null：空闲 dev_prepare：预备 addby 2012-4-13 dev_ring ：振铃 dev_wating:排队等待 dev_answer：应答 dev_hold：保持 dev_connect：通话 dev_three_talk：三方通话 dev_meeting：会议 四：协议包具体定义 1. 心跳包 1. 心跳包 11.. 心心跳跳包包 1 1 11）请求包 （1）描述 在登录CTI 系统后，客户端每隔5s 向服务段发送一个心跳包，保持连接，在30s之内 服务端没有收到心跳，则认为超时 超时时长： （2）类型定义： （3）：内容描述： ?xml version=1.0encoding=UTF-8? requestid=100000 type=heartbeat /request （4）字段描述： 字段 可选 类型 意义 （5）定时器时长：20s 2 2 22）响应包 （1）描述 告诉客户端请求成功或者失败，若失败，告诉失败原因。 （2）类型定义： （3）：内容描述： ?xml version=1.0encoding=UTF-8? responseid=100000 type=heartbeat versionCTIServer_R1.0.0/version now_time20120313174500/now_time /response （4）：字段描述： 字段 可选 类型 意义 version M Char[32] 告诉客户端后台的版本号 now_time M Char[32] 系统当前时间，时间格式： 20120313174500 2. 认证： 2. 认证： 22.. 认认证证：： 1 1 11）请求包 （1）描述 在登录CTI 系统之前，客户端发送一个认证请求包给服务器，验证通过后才能进行相 关操作 （2）：内容描述： ?xml version=1.0encoding=UTF-8? requestid=100000 type=auth operator_id2/operator_id employee_id2/employee_id pwd123