腾讯云、阿里云短信服务

2020-08-23

字数统计: 1.6k字 | 阅读时长≈ 7分

1、序言

业务中使用短信服务，主要使用了腾讯云和阿里云，价格和使用方式基本一样，但是推荐使用腾讯云，因为会送200条（穷鬼推荐）。

2、步骤

2.1 地址：

腾讯云短信服务
 阿里云短信服务

2.2 需要申请的参数

密钥id（腾讯云：secretId，阿里云：accessKeyId）
密钥（腾讯云：secretKey，阿里云：accessKeySecret）
短信签名（腾讯云：sign，阿里云：signName）
短信模板id（腾讯云：templateID，阿里云：templateCode）
appid(腾讯云专用：sdkAppid)

3、腾讯云

腾讯云短信申请

2.1 密钥申请（包括密钥和密钥id）

链接：腾讯云短信密钥申请
此处没有审核时间,会生成secretId和secretKey

2.2 短信签名申请

链接：腾讯云短信签名申请
一般两个小时能通过审核，开发需要用到短信签名内容

2.3 短信模板申请

链接：腾讯云短信模板申请
一般两个小时能通过审核（自定义模板需要注意格式，不然很容易不能通过审核），审核通过后需要使用模板ID

2.4 appid申请

链接：appid申请
此处没有审核时间，需要使用到appid
申请appid

到这里基本申请完毕，开始进入开发阶段

2.5 官方文档和实例代码

文档：腾讯云短信文档
使用腾讯云短信的小伙伴需要注意，腾讯云的文档更新不及时，示例代码也不一定正确，文档仅供参考
但是腾讯云提供了Open API Explorer在线测试工具（阿里云也有），点击相应的应用会生成代码，直接复制到自己的代码里就可以了。Explorer

2.6 正式使用

选择使用SDK开发，文档地址java SDK文档

2.6.1 添加maven依赖

<dependency>
     <groupId>com.tencentcloudapi</groupId>
     <artifactId>tencentcloud-sdk-java</artifactId>
     <version>3.1.62</version><!-- 注：这里只是示例版本号，请获取并替换为 最新的版本号 -->
</dependency>

2.6.2 发送短信

@Service
public class TencentSendSms {
    @Autowired
    private TencentDySmsParam param;

    private static final Logger log = LoggerFactory.getLogger(TencentSendSms.class);

    String ok = "Ok";

    public String send(String[] phoneArr, String[] templateParams) {
        StringBuilder result = new StringBuilder();
        try{
            Credential cred = new Credential("AKIDwmQq9FWmFTQp0vAx6ycyKPvA8sNchaSE", "4wYtyoeGlGWXJrCYEhvtd8g07pHWXHlj");

            HttpProfile httpProfile = new HttpProfile();
            httpProfile.setEndpoint("sms.tencentcloudapi.com");

            ClientProfile clientProfile = new ClientProfile();
            clientProfile.setHttpProfile(httpProfile);

            SmsClient client = new SmsClient(cred, "ap-nanjing", clientProfile);

            SendSmsRequest req = new SendSmsRequest();
            // 添加电话号码
            req.setPhoneNumberSet(this.toPullPhoneArr(phoneArr));
            // 添加短信签名
            req.setSign(param.getSign());
            // 添加模板编号
            req.setTemplateID(param.getTemplateID());
            // 添加sdkAppid
            req.setSmsSdkAppid(param.getSdkAppid());
            // 设置模板参数
            req.setTemplateParamSet(templateParams);

            SendSmsResponse resp = client.SendSms(req);
            result = new StringBuilder(SendSmsResponse.toJsonString(resp));
            System.out.println("返回结果：" + result);
            // 返回code，OK就是成功
            SendStatus[] sendStatusSet = resp.getSendStatusSet();
            for (SendStatus status : sendStatusSet) {
                if (ok.equals(status.getCode())) {
                    log.info(status.getPhoneNumber() + "短信发送成功！");
                    result.append("1");
                } else {
                    log.error(status.getPhoneNumber() + "短信发送失败！");
                    result.append("0");
                }
            }
        } catch (TencentCloudSDKException e) {
            log.error("短信发送异常");
            System.out.println(e.toString());
        }
        return result.toString();
    }

    public String[] toPullPhoneArr(String[] phoneArr) {
        return Arrays.stream(phoneArr).map(phone -> "+86" + phone).toArray(String[]::new);
    }
}

4、阿里云

申请方式和使用方式与腾讯云没什么差别，文档地址

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.1</version>
</dependency>

@Service
public class AliSendSms {
    @Autowired
    private AliDySmsParam dySms;

    private static final Logger log = LoggerFactory.getLogger(AliSendSms.class);

    public String send(String phone) throws ClientException {
        //设置超时时间-可自行调整
        System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
        System.setProperty("sun.net.client.defaultReadTimeout", "10000");
        //初始化ascClient需要的几个参数
        //短信API产品名称（短信产品名固定，无需修改）
        final String product = "Dysmsapi";
        //短信API产品域名（接口地址固定，无需修改）
        final String domain = "dysmsapi.aliyuncs.com";
        //替换成你的AK
        final String accessKeyId = dySms.getAccessKeyId();
        //你的accessKeySecret，参考本文档步骤2
        final String accessKeySecret = dySms.getAccessKeySecret();
        //初始化ascClient,暂时不支持多region（请勿修改）
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId,
                accessKeySecret);
        DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
        IAcsClient acsClient = new DefaultAcsClient(profile);

        //组装请求对象
        SendSmsRequest request = new SendSmsRequest();
        //使用post提交
        request.setMethod(MethodType.POST);
        //必填:待发送手机号。支持以逗号分隔的形式进行批量调用，批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式；发送国际/港澳台消息时，接收号码格式为国际区号+号码，如“85200000000”
        request.setPhoneNumbers(phone);
        //必填:短信签名-可在短信控制台中找到
        request.setSignName(dySms.getSignName());
        //必填:短信模板-可在短信控制台中找到，发送国际/港澳台消息时，请使用国际/港澳台短信模版
        request.setTemplateCode(dySms.getTemplateCode());
        //可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
        //友情提示:如果JSON中需要带换行符,请参照标准的JSON协议对换行符的要求,比如短信内容中包含\r\n的情况在JSON中需要表示成\\r\\n,否则会导致JSON在服务端解析失败
        //参考：request.setTemplateParam("{\"变量1\":\"值1\",\"变量2\":\"值2\",\"变量3\":\"值3\"}")
        request.setTemplateParam("{\"code\":\"123456\"}");
        //可选-上行短信扩展码(扩展码字段控制在7位或以下，无特殊需求用户请忽略此字段)
        //request.setSmsUpExtendCode("90997");

        //可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
        // request.setOutId("yourOutId");

        //请求失败这里会抛ClientException异常
        SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
        // 请求结果：isv.AMOUNT_NOT_ENOUGH消息账户余额不足
        System.out.println("请求结果=" + sendSmsResponse.getCode() + "；消息=" + sendSmsResponse.getMessage());
        if(sendSmsResponse.getCode() != null && sendSmsResponse.getCode().equals("OK")) {
            //请求成功
            log.info(phone + "短信发送成功");
        } else {
            log.error(phone + "消息发送失败，原因是：" + sendSmsResponse.getMessage());
        }
        return sendSmsResponse.getMessage();
    }
}

如果按照支持逻辑到这一步调用阿里短信服务发送短信，会报一个isv.AMOUNT_NOT_ENOUGH的问题，原因就是没充钱，需要先充钱，不像腾讯云会送短信

本文作者： tenyears
本文链接： https://tenyears94.gitee.io/2020/08/23/腾讯云、阿里云短信服务/
版权声明： 本博客所有文章转载请注明出处！