云MAS业务平台_中国移动http://mas.10086.cn/login
首页可下载不同协议的接口对接文档,这里以https为例
接口报文数据结构
连接地址:https://:/sms/submit
请求方式:post
数据类型:json(base64加密)
A:请求报文内容(一对一或多对一模式*注1):
名称 | 类型 | 说明 |
---|---|---|
ecName | String | 企业名称。 |
apId | String | 接口账号用户名。 |
mobiles | String | 收信手机号码。英文逗号分隔,每批次限5000个号码,例:“13800138000,13800138001,13800138002”。 |
content | String | 短信内容。 |
sign | String | 签名编码。在云MAS平台『管理』→『接口管理』→『短信接入用户管理』获取。 |
addSerial | String | 扩展码。依据申请开户的服务代码匹配类型而定,如为精确匹配,此项填写空字符串(“”);如为模糊匹配,此项可填写空字符串或自定义的扩展码,注:服务代码加扩展码总长度不能超过20位。 |
mac | String | 参数校验序列,生成方法:将ecName、apId、secretKey、mobiles、content、sign、addSerial按序拼接(无间隔符),通过MD5(32位小写)计算得出值。 |
响应报文内容:
名称 | 类型 | 说明 |
---|---|---|
rspcod | String | 响应状态,详见下表。 |
mgsGroup | String | 消息批次号,由云MAS平台生成,用于关联短信发送请求与状态报告,注:若数据验证不通过,该参数值为空。 |
success | boolean | 数据校验结果。 |
响应报文中rspcod返回对应值
rspcod | 说明 |
---|---|
IllegalMac | mac校验不通过。 |
IllegalSignId | 无效的签名编码。 |
InvalidMessage | 非法消息,请求数据解析失败。 |
InvalidUsrOrPwd | 非法用户名/密码。 |
NoSignId | 未匹配到对应的签名信息。 |
success | 数据验证通过。 |
TooManyMobiles | 手机号数量超限(>5000),应≤5000。 |
java代码实现
配置参数
cloud.mas.apId=xxxxxx
cloud.mas.secretKey=xxxxxx
cloud.mas.ecName=xxxxxx
cloud.mas.sign=xxxxxx
cloud.mas.url=xxxxxx
请求报文类
import lombok.Data;
@Data
public class MasSendReq {
private String ecName; //企业名称
private String apId; //接口账号用户名
private String secretKey; //密码
private String mobiles; //收信手机号码。英文逗号分隔,每批次限5000个号码,例:“13800138000,13800138001,13800138002”。
private String content; //发送短信内容
private String sign; //网关签名编码,必填,签名编码在中国移动集团开通帐号后分配,可以在云MAS网页端管理子系统-SMS接口管理功能中下载。
private String addSerial; //扩展码,根据向移动公司申请的通道填写,如果申请的精确匹配通道,则填写空字符串("")