定购业务.doc

PAGE11 短信平台业务模块 开发说明 V1.3 北京国都信业科技有限公司 2005-01-04 时间版本说明编辑者2005-01-04V1.0初稿第一版陈疆坡2005-01-07V1.0增加了定购业务接口2005-01-14V1.0增加了一些说明，修改了websend接口地址2005-01-19V1.10增加了状态报告调用接口顾宏标2005-01-21V1.10增加了定购PUSH接口顾宏标2005-01-24V1.2MO接口增加了ServcieID字段陈疆坡2005-02-05V1.3上行MO接口增加了两个参数；主动下行MT方式增加了两个接口参数；陈疆坡 概述 目前国都短消息接入平台为协尔公司的V3.5版，对于业务的开发支持存储过程方式及HTTP方式，为了便于业务的简单开发及第三方合作，目前本文档只提供HTTP调用试的接口说明。目前本版只使用HTTP同步方式来实现点播业务，对于定购业务的消息下发也采用HTTP调用接口方式。 至于HTTP异步方式的实现及聊天业务的处理将在未来的版本中说明。 本文档描述的接口及业务实现流程适用于移动MISC、联通、网通小灵通及电信小灵通。 MO及MT业务 一、业务流程 4 3 http resp 短信 平台 网关 业务处理模块 1 2 http:// 正常MO点播 (一)MO点播业务 此类业务即指必须有手机用户发送上行短消息，激发整个业务流程。 1、接收用户点播MO消息到短信平台； 2、根据目的号码+命令查找相应的业务URL地址, 将上行消息的内容及相关参数传递给业务处理程序； 3、业务处理程序生成短信内容，然后在同一HTTP请求连接中通过Response将短消息回应给短消息平台； 4、短消息平台根据业务定义及权限设置，补齐底层网关所需要的参数值，将短消息打包发送到短信网关 注：对于一般的点播业务，业务程序只需要回复短信内容即可，其它的信息，如：目的号、源号码、资费类别、资费金额、消息格式、LinkID、MsgID等信息，由平台根据业务配置参数自动填补。 (二)主动下发MT业务 主动MT业务 短信 平台 网关 Websend 或 Sendicp 接口 业务 模块 1 2 3 此类业务必须是由用户主动定购成功后，才可以调用此接口向用户发送短消息。此类业务计费模式分为定购按月扣费和定购按条扣费； 根据定购表，生成定购业务消息（如每日新闻），通过HTTP调用Websend或Sendipc接口； Wenbsend /Sendipc模块对消息进行鉴权，配置相应的参数，然后将消息发送的短信平台； 短信平台根据业务的路由关系将消息发送到相应的短信网关。 二、接口说明 (一)上行MO消息HTTP接口 HTTP请求URL串： /mo.asp?SrcAddrrcAddr_Type=DestAddr=5588123Msg=CTestMessageCmd=C%RequestType=MOLinkID=123123msgid=121243423 URL串红色部分为业务处理地址，可以是ASP、ASP.NET、JSP、Servlet、PHP或任何符合HTTP通讯规范的WEB服务地址。对于国都合作方，需要与业务人员联系将此地址告知国都短信维护部门，以便在平台中配置相应的参数。 URL蓝色的部分为国都短信平台生成的请求参数串，业务程序可以根据需要自己解析。 注：对于上行包含中文字符的短消息，消息的编码格式为GBK，对于大多数WEB平台来说，不用进行编码转换，可以直接取得中文内容，具体可以参见示例程序。 HTTP请求方法为：GET HTTP请求参数说明： 序号传出字段名称描述规则1SrcAddr主叫号码(源地址)2SrcAddr_Type主叫号码(源地址)类型0: 真实 1:伪码3DestAddr目标号码(目标地址)5588123 / 9958123 /4Msg消息内容(命令字)编码格式为GBK5Cmd命令字6RequestType请求消息类型MO：点播 Report：状态报告 Order：定购 Cancel：取消7ServiceID内部业务标识唯一标识一个业务，业务程序可根据需要处理。比如异步方式时，主动MT接口的第一个字段用此来赋值。同步方式的不用处理此参数。8LinkID点播业务使用的LinkID非点播类业务或不是合法的业务，该字段空9msgid短消息ID短信网关产生的消息ID HTTP响应结果：要发送的短消息内容。 注：长消息将由网关自动拆分，但只能计一次