宽乐通信用户短信接入规范v2.2

《宽乐通信用户短信接入规范v2.2》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、增值业务中心宽乐通信短信接入规范(V2.2)增值业务中心一.引言1.1概述宽乐通信短信接入规范定义了宽乐通信平台与企业客户系统之间的开放接口，主要是对短信处理流程、通信约定以及通信接口的定义。企业客户通过这一规范可以实现与宽乐通信平台对接，实现短信下发,接收回复,接收状态流程。1.2适用范围此规范适用于各行业企业客户。1.3接口优势l跨平台l可穿过防火墙l开发简单，低成本实现，业界已有成熟的框架或中间件l易于部署1.4技术支持:罗工Tel:13590234458QQ:8729153MSN:BrainyLuo@hotmail.com-9-

2、增值业务中心二.通信方式双方采用HTTP协议进行通信，双方互为服务器。如下图所示：宽乐通信客户平台HTTP方式MOHTTP方式MT-9-增值业务中心三.通信接口本部分主要描述宽乐通信平台与企业客户平台的接口定义，包括下发,上行,取状态接口统一访问的URL地址：http://183.62.139.6/sdk/SMS3.1上行回复MO接口3.1.1功能描述：用户上行后，客户平台从宽乐通信平台查询获取。客户平台成功获取后，宽乐通信平台修改标志为已获取。每次连接最大上限值1000条短信。3.1.2请求示例：http://183.62.139.6

3、/sdk/SMS?cmd=getmo&uid=0001&psw=123453.1.3参数说明：参数名称参数说明参数格式备注cmd命令字getmo取上行uid帐号非空psw密码非空密码需要MD5加密3.1.4响应说明：101无上行。100有上行。应答样例：1002#20100413113838#13590234458#0001#老地方见。3#20100413131114#13590234458#0001#请打办公室电话。-9-增值业务中心3.2下行短信MT接口3.2.1功能描述：可以通过此接口向用户下送消息。3.2.2请求示例：http:

4、//183.62.139.6/sdk/SMS?cmd=send&uid=0001&psw=12345&mobiles=13590234458&msgid=10002&msg=test3.2.3参数说明：参数名称参数说明参数格式备注cmd命令字send发送短信uid帐号非空psw密码非空密码需要MD5加密mobiles手机号码多个号码用逗号隔开;msgid消息编号长整型默认为0msg消息内容3.2.4响应说明：返回码含义100成功101失败102验证失败103号码有错104内容有错105操作频率过快106限制发送107参数不全-9-增值业

5、务中心3.3接收状态STATUS接口3.3.1功能描述：发送短信后，客户平台从宽乐通信平台查询获取。3.3.2请求示例：http://183.62.139.6/sdk/SMS?cmd=getstatus&uid=0001&psw=123453.3.3参数说明：参数名称参数说明参数格式备注cmd命令字getmo取上行uid帐号非空psw密码非空密码需要MD5加密3.3.4响应说明：应答格式为纯文本,每次可返回多条回复信息：状态码状态报告1状态报告2…第一行表示操作的状态码(100表示有状态信息)。第二行表示一条状态信息的手机号码,状态等.

6、各项之间用

7、分隔.消息编号

8、手机号码

9、状态码消息编号：对应发送是设置的msgid手机号码：接收短信息的号码状态码：0表示成功，1表示失败-9-增值业务中心应答样例：10010002#13590234458#010003#13590234458#010004#13590234458#0-9-增值业务中心3.4定时发送TSend接口3.4.1功能描述：可以通过此接口向用户定时下送消息。(此接口不返回状态,需要状态时请在需要发送的时间调用直接发送的接口)3.4.2请求示例：http://183.62.139.6/sdk/SMS?cmd=tse

10、nd&uid=0001&psw=12345&mobiles=13590234458&senddate=2010-05-01&sendtime=10:33&msg=test3.4.3参数说明：参数名称参数说明参数格式备注cmd命令字tsend定时发送uid帐号非空psw密码非空密码需要MD5加密mobiles手机号码多个号码用逗号隔开;senddate发送日期YYYY-MM-DDsendtime发送时间hh:mmmsg消息内容3.4.4响应说明：返回码含义100成功101失败102验证失败103号码有错104内容有错-9-增值业务中心10

11、5操作频率过快106限制发送107参数不全-9-增值业务中心3.5查询发送条数接口3.5.1功能描述：通过此接口查询帐户发送条数与可发送条数。3.5.2请求示例：http://219.134.64.3:10