云MAS平台HTTP2.1

云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 非法消息