大汉三通消息接口协议(CTCPP)

大汉三通消息接口协议产品名称大汉三通消息接口协议版本编号Build1.1文档编号RD-007发布者上海大汉三通网络通信有限公司发布日期2008-08-10最后修改日期2012-02-15大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第2页共12页版权所有(C)2003-2033网址：公司总机：021-38133333目录1、目的.................................................................................................................................................52、CTCPP功能概述..........................................................................................................................53、消息定义.........................................................................................................................................53.1.消息结构.........................................................................................................................53.2.消息头定义.....................................................................................................................53.3.消息类型定义.................................................................................................................63.4.客户端与服务器短消息定义.........................................................................................63.5.连接消息.........................................................................................................................73.5.2.断开连接消息.........................................................................................................83.5.3.短信下发消息.........................................................................................................83.5.4.短信上行消息.......................................................................................................103.5.5.短信状态报告消息................................................................................................113.5.6.链路检测消息.......................................................................................................12大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第3页共12页版权所有(C)2003-2033网址：公司总机：021-38133333保密本文件及其内容为上海大汉三通网络通信有限公司保密资料。本文件及其内容永远属于上海大汉三通网络通信有限公司拥有财产，在无上海大汉三通网络通信有限公司采用书面形式表示同意外，本文件a.不可以用于其他非原指定用途；b.不可以向第三方披露；c.不可采用任何形式进行复制和传播，包括但不限于传真、纸张邮件和电子邮件。大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第4页共12页版权所有(C)2003-2033网址：公司总机：021-38133333文档修改历史版本修改人日期描述V1.0未知2008-08-10创建文档V1.1黄天峰2011-03-23版本更新v1.2汤喜金2012-02-15更新3.5.3.2的result描述信息v1.3汤喜金2012-09-273.5.3.2新增错误码-10，签名不合法大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第5页共12页版权所有(C)2003-2033网址：公司总机：021-381333331、目的本文档旨在定义大汉三通公司消息接口协议的数据包类型以及数据包格式，方便其他软件或平台的接口对接开发。2、CTCPP功能概述短信下发；短信接收；短信状态报告传输；3、消息定义3.1.消息结构项目说明MessageHeader消息头(所有消息公共包头)MessageBody消息体消息由消息头和消息体组成。消息头和消息体采用仿XML的格式，并且都基于GBK编码。消息头格式如“head………………../head”，消息体如“body…………………./body”。3.2.消息头定义字段名描述len消息体长度seqid消息流水号,顺序累加,步长为1,循环使用（一对请求和应答消息的流水号必须相同）msgtype消息类型大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第6页共12页版权所有(C)2003-2033网址：公司总机：021-38133333注意：消息头的总长度必须要是100个字节的长度。如果不足100长度需要‘A’字符凑成100个字节。消息头举例：headlen0/lenseqid3421/seqidmsgtype-3/msgtype/headAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA3.3.消息类型定义3.4.客户端与服务器短消息定义字段名描述CTCPP_Connect1CTCPP_Connect_Resp-1CTCPP_Disconnect2CTCPP_Disconnect_Res-2CTCPP_ACTIVETEST3CTCPP_ACTIVETEST-3CTCPP_Submit_SMS4CTCPP_Submit_SMS_Resp-4CTCPP_Deliver_SMS5CTCPP_Deliver_SMS_Resp-5CTCPP_Report_SMS6CTCPP_Report_SMS_Resp-6大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第7页共12页版权所有(C)2003-2033网址：公司总机：021-381333333.5.连接消息3.5.1.1.CTCPP_Connect请求(客户端—服务端)字段名描述user用户名pass密码，密码可以使原始密码或者md5加密的密码。type连接类型0——连接只用于短信下发1——连接只用于短信和状态报告接收2——均可消息体举例：bodyuser1059/userpass7d0ea5c799061c2e41b2ffad2f0fa168/passtype2/type/body3.5.1.2.CTCPP_Connect_Resp(服务端—客户端)字段名描述result0——成功1——重复登录2——用户名无效3——密码错误4——非法IP5——其他，如接入方式错误，系统验证异常等消息体举例：body大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第8页共12页版权所有(C)2003-2033网址：公司总机：021-38133333result0/result/body3.5.2.断开连接消息3.5.2.1.CTCPP_Disconnect(客户端——)服务器端)无包体。3.5.2.2.CTCPP_Disconnect_Resp(服务器端——)客户端)无包体。3.5.3.短信下发消息3.5.3.1.CTCPP_Submit_SMS(客户端——服务器端)字段名描述to下发手机号码，多个手机号码以“,”隔开。from子码，下发子码。needreport是否需要状态报告，默认需要。（0——不需要，1——需要）msgfmt消息下发到网关的格式，默认158—UNICODE15—GBK4—二进制短信msg消息内容smsid指定消息的id，如果不指定服务器端将为其分配一个。priority优先级，根据优先级确定短信的下发顺序。（级别由0~9递增）feeaddress计费地址（计费手机号码：只适用于sp平台）fee计费（为sp通道专用:计费以分为单位）serviceid业务id(只适用于sp平台)大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第9页共12页版权所有(C)2003-2033网址：公司总机：021-38133333type短信内容类型（1：文本2：铃声3：图片4：flash5：wappush）pushurlWappush的url;linkid链接idconnid通道idpgid节目id(只适用于sp平台)mytypeid业务类型：（1：点播下发2：订阅结果3：取消订阅4：包月扣款请求5：订阅下发(包月)6：订阅下发(按条)7：自写短信8：免费短信）scheduletime下行时间。expiretime终止时间。moid关系上行id（回复短信时可以得到）tppidtpudhi消息体举例：bodyto13901999792/tofrom824/fromneedreport1/needreportmsgfmt15/msgfmtmsg消息内容…/msgsmsid225946/smsid/body3.5.3.2.CTCPP_Submit_SMS_Resp(服务器端——客户端)字段名描述result0——成功；-1——非法用户；-2——提交失败；-3——手机号码为空；大汉三通消息接口协议V1.2上海大汉三通网络通信有限公司上海张江高科技园区浦东软件园20号楼5层第10页共12页版权所有(C)2003-2033网址：公司总机：021-38133333-4——短信内容为空；-5——自定义短信编号无效；-6——余额不足；-7——含有非法关键字；-8——含有无效手机号码-9——处理时发生异常；-