中国移动通信有限公司政企客户分公司云MAS平台SDK接口1.0.1(HTTP版)

云MAS平台SDK1.0.1（HTTP版）用户手册

作者：中国移动通信有限公司政企客户分公司

完成日期：2015-12-7

签收人：

签收日期：

修改情况记录：

1云MAS平台HTTP开发说明

1.1简介

云MAS平台SDK HTTP版接口说明文档

1.2背景

系统名称：云MAS平台

项目开发者：中国移动通信集团政企客户分公司

1.3定义

MT Message Terminal——下行短信，即向手机终端发送短信

MO Message Original——上行短信，即手机用户向特服号码发送

短信

1.4环境

服务器具有直连访问互联网的能力。并且提供HTTP Server接收比较报告，状态报告，上行短信。

1.5云MAS平台与HTTP客户端数据交互流程

SDK收到的返回值说明：

➢“1.返回提交状态”，说明云MAS是否收到HTTP提交的数据；数据还未提交行业网关；

➢“4.返回审核结果”，说明云MAS已经对提交内容进行了审核；数据还未提交行业网关；

➢“7.返回短信回复”，短信已经提交网关；

➢“10.返回短信回执”，短信已被网关下发；

*因平台有流控设置，需要进行多条短信连续提交时，为保证提交速度和效率，请按照“1.返回提交状态”返回值判断是否提交下一条；

2数据结构说明

2.1MT提交报告数据结构

●类型（TYPE）：JSON

●用途用于内部，跟踪短信状态，不能用于判断短信是否正确送达，

2.2MT状态报告数据结构

●类型（TYPE）：JSON

●用途保存状态报告接口函数返回的短信内容，不能用于判断短信

2.3MO数据结构

●类型（Type）：JSON

3功能介绍及使用

3.1身份验证

●功能介绍

企业必须通过身份验证才能进行短信发送,身份验证用户名、密码和集团客户名称完成。

●请求申明

测试环境：.13:80/app/http/authorize

正式环境：.cn/app/http/authorize

●

●

3.2发送普通短信

HTTP客户端向云MAS平台发送请求，带上相应的请求参数，云MAS 平台接收请求，并进行验证，验证通过后进行短信发送。

●请求声明

测试环境：

正式环境：.cn/app/http/sendSms

●

●

返回短信批次号

3.3发送模板短信

●功能介绍

模板短信发送，HTTP客户端向云MAS平台发送请求，根据指定模板ID，传入模板所需参数发送短信，云MAS平台接收请求，并进行验证，验证通过后进行短信发送。

●函数声明

测试环境：.13:80/app/http/sendSmsByTemplate

正式环境：.cn/app/http/sendSmsByTemplate

●

返回短信批次号

3.4获取提交报告

●功能介绍

云MAS平台将提交报告采用POST方式推送至开户时设定的HTTP地址，如果推送失败，两秒后将再次推送，连续失败三次后将丢弃数据；数据结构参考

2.1 MT提交报告数据结构。

此方法获得的数据不能用于判断短信是否正确送达，短信是否送达以移动公司提供的账单为准

3.5获取状态报告

●功能介绍

云MAS平台将状态报告采用POST方式推送至开户时设定的HTTP地址，如果推送失败，两秒后将再次推送，连续失败三次后将丢弃数据；数据结构参考

2.2 MT状态报告数据结构。

此方法获得的数据不能用于判断短信是否正确送达，短信是否送达以移动公司提供的账单为准

3.6获取上行短信

●功能介绍

云MAS平台将上行短信采用POST方式推送至开户时设定的HTTP地址，如果推送失败，两秒后将再次推送，连续失败三次后将丢弃数据；数据结构参考

2.3 MO数据结构。

4附录

4.1常见问题

1.如何判断短信已经成功提交给云MAS平台？

HTTP请求返回MSG_GROUP，RET-CODE为SC:0000则表示短信已经成功提交给云MAS

平台；

2.HTTP登陆请求有时间间隔吗？

有，最大允许请求的时间间隔为2分钟；验签的超时时间为2个小时

3.HTTP请求最高速率多少？

HTTP请求最高限速10条/秒；

4.文档中提到了“提交报告”和“状态报告”，请问这两个有什么不同点和相同点？

提交报告：指HTTP客户端提交给云MAS的报告，报告由云MAS收到HTTP客户端

提交请求后发出；

状态报告：云MAS提交给行业网关，行业网关返回的报告，云MAS透传给HTTP客

户端；

5.发送长短信是否有字数上限，长短信是不是不需要客户端来拆分，而有云平台完

成？

长短信字数上限是500，最好不要超过400，长短信由云MAS完成拆分，客户端提

交一条即可；

6.发送短信签名，是不是由客户端发送短信时附带在短信内容后边发送即可？

发送短信签名由行业网关添加，客户发送时所选签名请参见页面中“SMS接口管理”

中下载的对应签名编码，发送时填写在短信参数（Sign，详见接口文档3.2中；

7.提交的号码数量有限制吗？

有，一次提交的号码数量不能超过200个；

8.关于回执数据说明

提交报告：指短信提交到云MAS平台和短信提交至网关的回执信息；

1)短信成功提交至云MAS并审核通过将返回CM:0000

2)短信成功提交至网关将返回CM:3000

状态报告：真实网关返回的状态报告，DELIVRD表示短信已成功到达用户终端；