1、 增值业务中心宽乐通信短信接入规范(V2.2)增值业务中心- 1 -一. 引言1.1 概述宽乐通信短信接入规范定义了宽乐通信平台与企业客户系统之间的开放接口,主要是对短信处理流程、通信约定以及通信接口的定义。企业客户通过这一规范可以实现与宽乐通信平台对接,实现短信下发,接收回复, 接收状态流程。1.2 适用范围此规范适用于各行业企业客户。1.3 接口优势 跨平台 可穿过防火墙 开发简单,低成本实现,业界已有成熟的框架或中间件 易于部署1.4 技术支持:罗工 Tel: 13590234458 QQ: 8729153 MSN: BrainyL 增值业务中心- 2 -宽乐通信二. 通信方式双方采用
2、HTTP 协议进行通信,双方互为服务器。如下图所示:HTTP 方式 MO HTTP 方式 MT客户平台增值业务中心- 3 -三. 通信接口本部分主要描述宽乐通信平台与企业客户平台的接口定义,包括下发,上行,取状态接口统一访问的 URL 地址:http:/183.62.139.6/sdk/SMS3.1 上行回复 MO 接口3.1.1 功能描述:用户上行后,客户平台从宽乐通信平台查询获取。客户平台成功获取后,宽乐通信平台修改标志为已获取。每次连接最大上限值 1000 条短信。3.1.2 请求示例:http:/183.62.139.6/sdk/SMS?cmd=getmomsgid 消息编号 长整型
3、默认为 0msg 消息内容3.2.4 响应说明:返回码 含义100 成功101 失败102 验证失败103 号码有错104 内容有错105 操作频率过快106 限制发送107 参数不全增值业务中心- 5 -3.3 接收状态 STATUS 接口3.3.1 功能描述:发送短信后,客户平台从宽乐通信平台查询获取。3.3.2 请求示例:http:/183.62.139.6/sdk/SMS?cmd=getstatussenddate 发送日期 YYYY-MM-DDsendtime 发送时间 hh:mmmsg 消息内容3.4.4 响应说明:返回码 含义100 成功101 失败102 验证失败103 号码有错104 内容有错增值业务中心- 8 -105 操作频率过快106 限制发送107 参数不全增值业务中心- 9 -3.5 查询发送条数接口3.5.1 功能描述:通过此接口查询帐户发送条数与可发送条数。3.5.2 请求示例:http:/219.134.64.3:10000/sdk/SMS?cmd=getnum&uid=0001&psw=123453.5.3 参数说明:参数名称 参数说明 参数格式 备注cmd 命令字 getnum取发送条数信息uid 帐号 非空psw 密码 非空密码需要MD5 加密3.5.4 响应说明:101 错误。100 # 已发送条数 # 还可发送条数