云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

联系客服:779662525#qq.com(#替换为@) 苏ICP备20003344号-4