中国移动云mas短信对接(http)

一.登录官网,下载http接入文档

官网地址为:云mas业务平台

在这里插入图片描述

二.创建http短信接口

登录中国移动云mas平台,新建短信接口:

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

业务流程:

用户名:若指定为协议,则用户名不可重名,必须唯一;若指定为sdk,则用户名可重名。限制6位字符

用户密码:6-20位字符组成。

IP地址:是接入用户的IP地址,用来鉴权用户的,这个IP地址暂时没有使用

所属分组:所属分组记录当前用户所在组织架构。

生效|失效日期:非必填字段,不填为永久有效

协议:五种选择方式,CMPP2.0、CMPP2.0s、CMPP3.0、SDK、HTTP。选择SDK、HTTP时,不需要对用户名重名做全局校验;选择CMPP2.0、CMPP2.0s、CMPP3.0协议时,需要对用户名是否重名做校验。
回执状态: SMS接口用户是否接收回执,若选择开通则在发送成功时,会发送回执状态报告
SDK状态:只对当前SDK用户可用。开启代表当前SDK用户可用,关闭代表SDK用户不可用。
安全认证:IP白名单认证,暂未生效。

三.java开发工具类

1.根据文档编写对应实体类

SendReq.java:

/**集团客户名称*/
private String ecName;
/**用户名*/
private String apId;
/**密码*/
private String secretKey;
/**手机号码逗号分隔。(如“1813728****,1813728****,1813728****”)*/
private String mobiles;
/**发送短信内容*/
private String content;
/**网关签名编码,必填,签名编码在中国移动集团开通帐号后分配,可以在云MAS网页端管理子系统-SMS接口管理功能中下载。*/
private String sign;
/**扩展码,根据向移动公司申请的通道填写,如果申请的精确匹配通道,则填写空字符串(""),否则添加移动公司允许的扩展码。*/
private String addSerial;
/**按文档要求加密后的mac*/
private String mac;
// 省略get set方法

SendRes.java:

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

2.短信发送工具类

package demo.krt;

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;

/**
 * @version 1.0
 * @Author: lyp
 * @Date: 2021/2/27 15:09
 */
public class SMSUtils {


    /**账号*/
	private static String apId = "";
	/**密码*/
	private static String secretKey = "";
	/**集团名称*/
	private static String ecName = "";
	/**网关签名编码*/
	private static String sign = "";
	/**拓展码(可以为空)*/
	private static String addSerial = "";
	/**url*/
	private static String url = "http://112.35.1.155:1992/sms/norsubmit";

    /**
     * 多用户发送短信信息
     *
     * @param mobiles 手机号码逗号分隔
     * @param content 短信内容
     * @return 返回1表示成功,0表示失败
     * @throws IOException
     */
    public static boolean sendMsg(String mobiles, String content) throws IOException {
        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());

        sendReq.setMac(Md5Util.MD5(stringBuffer.toString()).toLowerCase());

        String reqText = JSON.toJSONString(sendReq);

        // BASE64编码
        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 true;
        } else {
            return false;
        }
    }

    /**
     * main方法测试发送短信,返回1表示成功,0表示失败
     *
     * @param args
     * @throws IOException
     */
    public static void main(String[] args) throws IOException {
        String msg = "这是发送短信的内容!";
        sendMsg("186****7603", msg);
    }

    /**
     * 向指定 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;
    }


}

3.md5加密工具类(32位)

package demo.krt;

import java.security.MessageDigest;

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

import org.apache.commons.codec.binary.Base64;

/**
 * @version 1.0
 * @Author: lyp
 * @Date: 2021/2/27 15:11
 */
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());
    }


}

四.注意(有坑)

apId和secretKey一般不会搞错,

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

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

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

MD5加密过程中一定要注意字符编码,不同的字符编码加密后结果可能不一,例:

Smsa.1867603测试短信发送UsL
760f8998451f7f94d4ac1344094*****

Smsa.1867603测试短信发送UsL
41b48561faf3411b407110f9445*****

看起来完全一样,加密后结果却不一样,导致mac校验失败

加密前指定字符编码:

byte[] strTemp = plainText.getBytes(“UTF-8”);

五.其他问题排查请查阅官方文档

  • 17
    点赞
  • 32
    收藏
    觉得还不错? 一键收藏
  • 6
    评论
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值