移动云MAS平台短信接口

1创建接口账号

登陆平台（mas.10086.cn），路径：『管理』→『接口管理』→『新建短信接口』，根据页面提示创建接口账号。

*用户名对应下文apId，用户密码对应下文secretKey；

*需要接收回执或上行短信均需自行搭建HTTP服务。

2获取签名信息

路径：『管理』→『接口管理』→『短信接入用户管理』，直接点击『签名下载』获取签名信息。

*下载的签名信息文件中，“签名编码”对应下文sign；“是否精确匹配”为“是”时下文addSerial应为空字符串，为“否”时可为空字符串或填写扩展码，服务代码+扩展码总长度不能超过20位。

3接口定义

    1发送一对一/一对多普通短信（一种短信内容对应一个/多个手机号）

        1）业务功能

        HTTP客户端向云MAS平台发送短信任务请求，云MAS平台接收到请求后验证数据，验证通过将数据发送给短信网关。

        2）数据传输

            a.连接地址：http://112.35.1.155:1992/sms/norsubmit

             *此地址仅供接口程序访问云MAS平台，浏览器无法访问。

             b.请求

        类型：JSON。

        请求方式：POST。       

        数据编码方式：BASE64。

名称	类型	说明
ecName	String	企业名称。
apId	String	接口账号用户名。
mobiles	String	收信手机号码。英文逗号分隔，每批次限5000个号码，例：“13800138000,13800138001,13800138002”。
content	String	短信内容。如content中存在双引号，请务必使用转义符\在报文中进行转义（使用JSON转换工具转换会自动增加转义符），否则会导致服务端解析报文异常。
sign	String	签名编码。在云MAS平台『管理』→『接口管理』→『短信接入用户管理』获取。
addSerial	String	扩展码。依据申请开户的服务代码匹配类型而定，如为精确匹配，此项填写空字符串（""）；如为模糊匹配，此项可填写空字符串或自定义的扩展码，注：服务代码加扩展码总长度不能超过20位。
mac	String	参数校验序列，生成方法：将ecName、apId、secretKey、mobiles、content、sign、addSerial按序拼接（无间隔符），通过MD5（32位小写）计算得出值。

                c.响应

名称	类型	说明
rspcod	String	响应状态，详见下表。
mgsGroup	String	消息批次号，由云MAS平台生成，用于关联短信发送请求与状态报告，注：若数据验证不通过，该参数值为空。
success	boolean	数据校验结果

rspcod	说明
IllegalMac	mac校验不通过。
IllegalSignId	无效的签名编码。
InvalidMessage	非法消息，请求数据解析失败。
InvalidUsrOrPwd	非法用户名/密码。
NoSignId	未匹配到对应的签名信息。
success	数据验证通过。
TooManyMobiles	手机号数量超限（>5000），应≤5000。

                 d.示例

请求

{"ecName":"政企分公司测试", "apId":"demo0", "mobiles":"13800138000", "content":"移动改变生活。", "sign":"DWItALe3A", "addSerial":"", "mac":"7997ddb079db2155b517b21b2a812370"}

BASE64编码后：

eyJjb250ZW50IjogIlx1NzlmYlx1NTJhOFx1NjUzOVx1NTNkOFx1NzUxZlx1NmQzYlx1MzAwMiIsICJzaWduIjogIkRXSXRBTGUzQSIsICJhcElkIjogImRlbW8wIiwgIm1hYyI6ICI3OTk3ZGRiMDc5ZGIyMTU1YjUxN2IyMWIyYTgxMjM3MCIsICJlY05hbWUiOiAiXHU2NTNmXHU0ZjAxXHU1MjA2XHU1MTZjXHU1M2Y4XHU2ZDRiXHU4YmQ1IiwgImFkZFNlcmlhbCI6ICIiLCAic2VjcmV0S2V5IjogIjEyM3F3ZSIsICJtb2JpbGVzIjogIjEzODAwMTM4MDAwIn0=

字符集为UTF-8。

Java代码示例

响应成功，例：

{"msgGroup":"0927152506001000833076","rspcod":"success","success":true}

响应失败，例：

{ "msgGroup": "", "rspcod": "InvalidUsrOrPwd", "success": false}

4问题排查

InvalidUsrOrPwd

1. 检查apId、secretKey等参数的正确性。
2. 参数顺序是否为ecName、apId、mobiles、content、sign、addSerial、mac。
3. 编码格式是否为UTF-8。把经过BASE64编码后的数据解码，如有乱码说明编码格式不是UTF-8。
4. 解码地址：http://www1.tc711.com/tool/BASE64.htm，该地址仅供参考。

IllegalMac

1. 将ecName、apId、secretKey、mobiles、content、sign、addSerial按序拼接（无间隔符）成字符串，例：
2. 分别在本地和在线加密工具使用MD5（32位小写）加密。
3. 比对结果，如不一致自行修改本地加密算法。

MD5加密地址：MD5在线加密 - MD5加密工具 - MD5在线生成，该地址仅供参考。

响应成功，未收到短信

        通过创建账号时配置的接收状态报告的URL或登陆云MAS平台通过话单查询回执情况（路径：『报表』→『统计报表』→『话单查询』）。

注：移动云MAX平台短信接口一定要注意编码问题，仅支持UTF-8，其他编码会报错。