中国移动云MAS平台 HTTP(JAVA版) 接口发送普通短信

电玩女神 2022-04-23 22:34 1583阅读 0赞

**下载用户操作手册 和 HTTP接口文档 深入了解云MAS**

![20190409212916222.png][]

### 一、创建HTTP短信接口 ###

**1、登录中国移动云MAS平台，新建短信接口**

**1）简要说明**

新建短信接口（简称SMS接口），是为集团客户创建可以使用接口发送短信的用户。该用户只能通过指定协议（CMPP2.0、CMPP2.0s、CMPP3.0、SDK、HTTP）连接网关，连接网关成功后，该用户可以通过接口进行发送短信。

**2）业务流程**

1.      界面展示：参见图3-20-1-1新建SMS接口。
2.      用户名：若指定为协议，则用户名不可重名，必须唯一；若指定为sdk，则用户名可重名。限制6位字符
3.      用户密码：6-20位字符组成。
4.      IP地址：是接入用户的IP地址，用来鉴权用户的，这个IP地址暂时没有使用。
5.      所属分组：所属分组记录当前用户所在组织架构。
6.      生效|失效日期：非必填字段。
7.      协议：五种选择方式，CMPP2.0、CMPP2.0s、CMPP3.0、SDK、HTTP。选择SDK、HTTP时，不需要对用户名重名做全局校验；选择CMPP2.0、CMPP2.0s、CMPP3.0协议时，需要对用户名是否重名做校验。
8.      回执状态： SMS接口用户是否接收回执，若选择开通则在发送成功时，会发送回执状态报告。
9.      SDK状态：只对当前SDK用户可用。开启代表当前SDK用户可用，关闭代表SDK用户不可用。
10.   安全认证：IP白名单认证，暂未生效。

**  **![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70][]

**2、接口创建好之后，注意标记的地方，后面用的到**

开启：新建的SMS接口开启方可使用。

**关闭**：已开启的接口用户可以进行关闭，选择后进行关闭，关闭后该用户有效，但是不能操作。

接口文档下载：下载集团客户SMS接口用户的所有接口文档。

**签名下载**：导出全部用户的签名数据

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70 1][]

### **二、JAVA开发工具类（详情阅读 HTTP.docx）** ###

**1、model 类**

**    **![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70 2][]

/**
     * 发送短信请求实体
     */
    public class SendReq {
        private String ecName;		//集团客户名称
        private String apId;		//用户名
        private String secretKey;	        //密码
        private String mobiles;		//手机号码逗号分隔。(如“18137282928,18137282922,18137282923”)
        private String content;		//发送短信内容
        private String sign;		//网关签名编码，必填，签名编码在中国移动集团开通帐号后分配，可以在云MAS网页端管理子系统-SMS接口管理功能中下载。
        private String addSerial;	        //扩展码，根据向移动公司申请的通道填写，如果申请的精确匹配通道，则填写空字符串("")，否则添加移动公司允许的扩展码。
        private String mac;			//API输入参数签名结果，签名算法：将ecName，apId，secretKey，mobiles，content ，sign，addSerial按照顺序拼接，然后通过md5(32位小写)计算后得出的值。
    
        //get()和set()方法
    }

/**
     * 发送短信响应实体
     */
    public class SendRes {
        private String rspcod;	//响应状态码
        private String msgGroup;	//消息批次号，由云MAS平台生成，用于验证短信提交报告和状态报告的一致性（取值msgGroup）注:如果数据验证不通过msgGroup为空
        private boolean success;	//数据校验结果
    
        //get()和set()方法
    }

**2、SMSUtils 发送短信工具类**

import java.io.BufferedReader;
    import java.io.IOException;
    import java.io.InputStreamReader;
    import java.io.OutputStreamWriter;
    import java.net.URL;
    import java.net.URLConnection;
    import java.text.SimpleDateFormat;
    import java.util.Calendar;
    
    import org.apache.commons.codec.binary.Base64;
    
    import com.alibaba.fastjson.JSON;
    
    import cn.com.jandar.common.dto.SendReq;
    import cn.com.jandar.common.dto.SendRes;
    
    public class SMSUtils {
       
        private static String apId="smsmas";
        private static String secretKey="123456";
        private static String ecName = "xxxxxx";	//集团名称
        private static String sign = "xxxx";	//网关签名编码
        private static String addSerial = "";	//拓展码 填空
        public static String url = "http://112.35.1.155:1992/sms/norsubmit";//请求url
    
        /**
         * 多用户发送短信信息
         * @param mobiles 手机号码逗号分隔
         * @param content 短信内容
         * @return 返回1表示成功，0表示失败
         * @throws IOException
         */
        public static int sendMsg(String mobiles,String content) throws IOException{
        	Calendar calendar = Calendar.getInstance();		
    	SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    	String nowDatestr = sdf.format(calendar.getTimeInMillis()); 
    	content += nowDatestr; //短信内容后跟个日期时间（可有可无），需求要求
    		
            SendReq sendReq = new SendReq();
            sendReq.setApId(apId);
            sendReq.setEcName(ecName);
            sendReq.setSecretKey(secretKey);
            sendReq.setContent(content);
            sendReq.setMobiles(mobiles);
            sendReq.setAddSerial(addSerial);
            sendReq.setSign(sign);
    
            StringBuffer stringBuffer = new StringBuffer();
            stringBuffer.append(sendReq.getEcName());
            stringBuffer.append(sendReq.getApId());
            stringBuffer.append(sendReq.getSecretKey());
            stringBuffer.append(sendReq.getMobiles());
            stringBuffer.append(sendReq.getContent());
            stringBuffer.append(sendReq.getSign());
            stringBuffer.append(sendReq.getAddSerial());
    
            //System.out.println(stringBuffer.toString());
            sendReq.setMac(Md5Util.MD5(stringBuffer.toString()).toLowerCase());
            //System.out.println(sendReq.getMac());
    
            String reqText = JSON.toJSONString(sendReq);
            
            String encode = Base64.encodeBase64String(reqText.getBytes("UTF-8"));
            //System.out.println(encode);
    
            String resStr = sendPost(url,encode);
    
            System.out.println("发送短信结果："+resStr);
    
            SendRes sendRes = JSON.parseObject(resStr,SendRes.class);
    
            if(sendRes.isSuccess() && !"".equals(sendRes.getMsgGroup()) && "success".equals(sendRes.getRspcod())){
                return 1;
            }else{
                return 0;
            }
        }
    
      /*
        //main方法测试发送短信，返回1表示成功，0表示失败  
       	public static void main(String[] args) throws IOException{
        	String msg = "这是发送短信的内容！";
        	int result = sendMsg("183xxxx65xx,183xxxx12xx",msg);
            System.out.println("==="+result);
        }*/
    
        /**
         * 向指定 URL 发送POST方法的请求
         *
         * @param url
         *            发送请求的 URL
         * @param param
         *            请求参数
         * @return 所代表远程资源的响应结果
         */
        private static String sendPost(String url, String param) {
            OutputStreamWriter out = null;
    
            BufferedReader in = null;
            String result = "";
            try {
                URL realUrl = new URL(url);
                URLConnection conn = realUrl.openConnection();
                conn.setRequestProperty("accept", "*/*");
                conn.setRequestProperty("contentType","utf-8");
                conn.setRequestProperty("connection", "Keep-Alive");
                conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)");
                conn.setDoOutput(true);
                conn.setDoInput(true);
    
                out = new OutputStreamWriter(conn.getOutputStream());
                out.write(param);
                out.flush();
    
    
                in = new BufferedReader(
                        new InputStreamReader(conn.getInputStream()));
                String line;
                while ((line = in.readLine()) != null) {
                    result += "\n" + line;
                }
            } catch (Exception e) {
                e.printStackTrace();
            } finally {
                try {
                    if (out != null) {
                        out.close();
                    }
                    if (in != null) {
                        in.close();
                    }
                } catch (IOException ex) {
                    ex.printStackTrace();
                }
            }
            return result;
        }
    
    }

**用到 MD5 和 base64加密，json字符串转对象和对象转json字符串**，使用的是 com.alibaba.fastjson.JSON（也可以使用其他架包）。

**注意: **

apId和secretKey一般不会搞错，

但是**集团名称ecName一定要写对**，否则就会提示\{“msgGroup”:”“,”rspcod”:”InvalidUsrOrPwd”,”success”:false\}，无效的用户名和密码，

还有一个就是mac字段sendReq.setMac(Md5Util.MD5(stringBuffer.toString()).toLowerCase());

MD5加密过后**一定要把它变成小写.toLowerCase()**，否则也会出错。

**3、MD5解密工具类**

import java.security.MessageDigest;
    
    import javax.crypto.Mac;
    import javax.crypto.spec.SecretKeySpec;
    
    import org.apache.commons.codec.binary.Base64;
    
    /**
     * MD5加密/验证工具类
     * 
     * @author bluesky
     * 
     */
    public class Md5Util {
        static final char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7',
                '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
    
        /**
         * 生成MD5码
         * 
         * @param plainText
         *            要加密的字符串
         * @return md5值
         */
        public final static String MD5(String plainText) {
            try {
                byte[] strTemp = plainText.getBytes("UTF-8");
                MessageDigest mdTemp = MessageDigest.getInstance("MD5");
                mdTemp.update(strTemp);
                byte[] md = mdTemp.digest();
                int j = md.length;
                char str[] = new char[j * 2];
                int k = 0;
                for (int i = 0; i < j; i++) {
                    byte byte0 = md[i];
                    str[k++] = hexDigits[byte0 >>> 4 & 0xf];
                    str[k++] = hexDigits[byte0 & 0xf];
                }
                return new String(str);
            } catch (Exception e) {
                return null;
            }
        }
    
        /**
         * 生成MD5码
         * 
         * @param plainText
         *            要加密的字符串
         * @return md5值
         */
        public final static String MD5(byte[] plainText) {
            try {
                byte[] strTemp = plainText;
                MessageDigest mdTemp = MessageDigest.getInstance("MD5");
                mdTemp.update(strTemp);
                byte[] md = mdTemp.digest();
                int j = md.length;
                char str[] = new char[j * 2];
                int k = 0;
                for (int i = 0; i < j; i++) {
                    byte byte0 = md[i];
                    str[k++] = hexDigits[byte0 >>> 4 & 0xf];
                    str[k++] = hexDigits[byte0 & 0xf];
                }
                return new String(str);
            } catch (Exception e) {
                return null;
            }
        }
    
        /**
         * 先进行HmacSHA1转码再进行Base64编码
         * @param data  要SHA1的串
         * @param key   秘钥
         * @return
         * @throws Exception
         */
        public static String HmacSHA1ToBase64(String data, String key) throws Exception {
            SecretKeySpec signingKey = new SecretKeySpec(key.getBytes(), "HmacSHA1");  
            Mac mac = Mac.getInstance("HmacSHA1");  
            mac.init(signingKey);  
            byte[] rawHmac = mac.doFinal(data.getBytes());  
            return Base64.encodeBase64String(rawHmac);
        }
    
        /**
         * 校验MD5码
         * 
         * @param text
         *            要校验的字符串
         * @param md5
         *            md5值
         * @return 校验结果
         */
        public static boolean valid(String text, String md5) {
            return md5.equals(MD5(text)) || md5.equals(MD5(text).toUpperCase());
        }
    
        /**
         * 
         * @param params
         * @return
         */
        public static String MD5(String... params) {
            StringBuilder sb = new StringBuilder();
            for (String param : params) {
                sb.append(param);
            }
            return MD5(sb.toString());
        }
    }

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70 3][]

**注意：**String encode = Base64.encodeBase64String(reqText.getBytes("UTF-8"));

多了解 中国移动云MAS平台的操作手册与接口文档，对开发帮忙很大

参考文章：[中国移动 云MAS平台HTTP2.1（HTTP版）发送普通短信][_MAS_HTTP2.1_HTTP]

[20190409212916222.png]: /images/20220222/2b603c59365345df9388eaca33795546.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70]: /images/20220222/5e724a6706fa4c8abbafcb629381300e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70 1]: /images/20220222/6e1ce450823942d091dfba90f7b01341.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70 2]: /images/20220222/b8ac2b9770304809998b6301230817fa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQyNDAyODU0_size_16_color_FFFFFF_t_70 3]: /images/20220222/6c9e267a316b43f2a655dae935ad3ba8.png
[_MAS_HTTP2.1_HTTP]: https://blog.csdn.net/qq_29254177/article/details/81386638