网易云信模板短信集成-java

来源：情诗网 2020-12-07 分类：情话短信

在日常开发中难免会有发送通知短信到用户手机的需求，那网易云信的模板短信是个不错的选择。

1 说明

1.1 背景

网易云信是网易公司2015年11月推出了一款IM云服务产品。

1.2 价格

注册账号之后送20条短信。之后最少40000条短信起步（2000RMB），0.05一条，短信有效期2年。短信还可跟验证码短信等业务共享。

计费规则：云信短信计费包括短信签名，70字计1条短信费，超过70字则以67字每条计费，当短信中出现中文字符，则单个汉字、英文、标点和空格等都算一个字。

2 体验

官方有售前售后电话，也有QQ客服，QQ客服响应速度慢，建议直接打电话。购买后有一对一客户经理。服务态度还可以，对产品有什么疑问可以随时打电话得到解决。
后台查询可以分为两种方式查询1、按照指定日期查询发送量；2、查询一天发送明细或者指定手机号码查询。
短信有签名“【云短信】”字样。要改变短信签名要申请，分企业申请和个人申请。企业要上传营业执照，个人开发者要上传个人手持身份证的正反面。值得一提的是官方虽然提供了个人开发者申请更改短信签名的途径，但我打电话后得知个人开发者是通不过请求的。
通知模板最多可创建400个，还有审核机制，通过速度取决于你是否已经购买短信。慢则大概48小时，快则1个小时。我怎么知道？我购买前后体验过。

3 集成

官方文档

返回状态码

Server Http API接口文档

3.1 计算checksum

官方概述

计算CheckSum的java代码举例如下：


import java.security.MessageDigest;

public class CheckSumBuilder {

    public static String getCheckSum(String appSecret, String nonce, String curTime) {
        return encode("sha1", appSecret + nonce + curTime);
    }

    public static String getMD5(String requestBody) {
        return encode("md5", requestBody);
    }

    private static String encode(String algorithm, String value) {
        if (value == null) {
            return null;
        }
        try {
            MessageDigest messageDigest = MessageDigest.getInstance(algorithm);
            messageDigest.update(value.getBytes());
            return getFormattedText(messageDigest.digest());
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

    private static String getFormattedText(byte[] bytes) {
        int len = bytes.length;
        StringBuilder buf = new StringBuilder(len * 2);
        for (int j = 0; j < len; j++) {
            buf.append(HEX_DIGITS[(bytes[j] >> 4) & 0x0f]);
            buf.append(HEX_DIGITS[bytes[j] & 0x0f]);
        }
        return buf.toString();
    }

    private static final char[] HEX_DIGITS = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd',
            'e', 'f' };
}

3.2 写工具类

网易云信提供的模板短信由固定内容与多个变量构成，其中 " %s " 为需要接口替换的变量，变量内容可以是汉字、字母、数字或者特殊字符组合，但单个变量内容长度不得超过30个字，一条模板短信中变量数量不限制，短信模板总字数限制300字内；

public class MessageTools {
    private static String APPKEY = "ee23e57324974ab73343c3688c7e2c95";//开发者平台分配的appkey
    private static String APPSECRET = "ee23e5732";//安全码不需要提交，这样数据被截获也不能被修改，否则将不能被校验
    private static String NONCE = "ee23e5732";//随机数（最大长度128个字符）
    private static String TEMPLATEID = "1234567";//短信模板ID

    public String sendMessage(String doctorPhoneNumber, String messageContent) {
        String curTime = String.valueOf((new Date()).getTime() / 1000L);//当前UTC时间戳，从1970年1月1日0点0 分0 秒开始到现在的秒数(String)
        String checkSum = CheckSumBuilder.getCheckSum(APPSECRET, NONCE, curTime);//SHA1(AppSecret + Nonce + CurTime),三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写)
        
        String url = "https://api.netease.im/sms/sendtemplate.action/" + "?templateid=" + TEMPLATEID + "&mobiles=[\""
                + doctorPhoneNumber + "\"]" + "&params=" + "[\"" + messageContent + "\"]";

        //spring RestTemplate发送请求
        RestTemplate restTemplate = new RestTemplate();
        HttpHeaders headers = new HttpHeaders();
        MediaType type = MediaType.parseMediaType("application/x-www-form-urlencoded; charset=UTF-8");

        headers.set("AppKey", APPKEY);
        headers.set("Nonce", NONCE);
        headers.set("CurTime", curTime);
        headers.set("CheckSum", checkSum);
        headers.setContentType(type);

        HttpEntity<String> entity = new HttpEntity<String>(headers);

        String smsReturns = restTemplate.postForObject(url, entity, String.class);
        
        return smsReturns;//json格式返回状态码
    }
}

至此调用方法即可发送短信！参数因模板中的变量多少而更变。