发布时间 : 星期三 文章云MAS平台HTTP2.1更新完毕开始阅读a87bab403069a45177232f60ddccda38376be1c1
云MAS平台HTTP2.1（HTTP版）
接 口 文 档
接口定义
1.1 发送普通短信
1.1.1.1
业务功能
HTTP客户端向云MAS平台发送请求，带上相应的请求参数，云MAS平台接收请求，并进行验证，验证通过后进行短信发送。
1.1.1.1.1 传输数据结构
? 正式环境地址：http://112.35.1.155:1992/sms/norsubmit
? 类型（TYPE）：JSON ? 请求方式：post
? 传输数据加密方式:base64
请求 参数名称 ecName apId secretKey 数据类型 说明 集团客户名称 用户名 密码 手机号码逗号分隔。 (如“18137282928,18137282922,18137282923”) 发送短信内容 网关签名编码，必填，签名编码在中国移动集团开通帐号后分配，可以在云MAS网页端管理子系统-SMS接口管理功能中下载。 扩展码，根据向移动公司申请的通道填写，如果申请的精确匹配通道，则填写空字符串(\，否则添加移动公司允许的扩展码 string string string string string string mobiles content sign addSerial string mac String API输入参数签名结果，签名算法：将ecName，apId，secretKey，mobiles，content ，sign，addSerial按照顺序拼接，然后通过md5(32位小写)计算后得出的值
响应
? 类型（TYPE）：JSON
响应参数 rspcod msgGroup 数据类型 描述 响应码(根据下面返回值判断) 消息批次号，由云MAS平台生成，用于验证短信提交报告和状态报告的一致性（取值msgGroup）注:如果数据验证不通过msgGroup为空 true,false string string success boolean
返回值 返回值 描述 IllegalMac InvalidMessage InvalidUsrOrPwd NoSignId IllegalSignId success TooManyMobiles 无效mac 非法消息 非法用户名或密码 未找到签名 无效的签名 成功 手机号超出最大上限（5000）
数据案例 组装数据
{\”你好\集团客户”,\,\
Base64加密
eyJhZGRTZXJpYWwiOiIxMTEiLCJhcElkIjoiMzAxNTgzIiwiY29udGVudCI6IuS9oOWlvSIsImVjTmFtZSI6IumbhuWbouWuouaItyIsIm1hYyI6IjVjYTY5ZTZmYTdkZWM5MGM1NmQwYWYwYWQ5NWQwMDE1IiwibW9iaWxlcyI6IjE4MTM3ODI4OTgzIiwic2VjcmV0S2V5IjoiMzAxNTgzIiwic2lnbiI6ImxzaWduMDAxIn0= 字符集是UTF-8 Java代码案例
响应失败例如:{ \
响应成功例如:{ \Java代码案例
1.2 发送模板短信
1.2.1.1
业务功能
模板短信发送，HTTP客户端向云MAS平台发送请求，根据指定模板ID，传入模板所需参数发送短信，云MAS平台接收请求，并进行验证，验证通过后进行短信发送。
1.2.1.1.1 传输数据结构
? 正式环境地址：http://112.35.1.155:1992/sms/tmpsubmit
? 类型（TYPE）：JSON ? 请求方式:post
? 传输数据加密方式:base64
请求
参数名称 ecName apId secretKey templateId 数据类型 说明 集团客户名称 用户名 密码 模版ID，模板由用户在中国移动集团提供的客户业务平台上，由客户自己增加短信模版的信息。 手机号码逗号分隔。 (如“18137282928,18137282922,18137282923”) [\参数一\参数二\格式 网关签名编码，必填，签名编码在中国移动集团开通帐号后分配，可以在云MAS网页端管理子系统-SMS接口管理功能中下载。 扩展码，根据向移动公司申请的通道填写，如果申请的精确匹配通道，则填写空字符串(\，否则添加移动公司允许的扩展码 string string string string string String string mobiles params sign addSerial string mac string API输入参数签名结果，签名算法：将ecName，apId，secretKey，templateId，mobiles，params，sign，addSerial按照顺序拼接，然后通过md5(32位小写)计算后得出的值 响应
? 类型（TYPE）：JSON
响应参数 rspcod msgGroup 数据类型 描述 响应码(根据下面返回值判断) 消息批次号，由云MAS平台生成，用于验证短信提交报告和状态报告的一致性（取值msgGroup）注:如果数据验证不通过msgGroup为空 true,false string string success
boolean 返回值 返回值 描述 无效mac IllegalMac InvalidMessage 非法消息