Java版阿里云通信短信发送API接口实例（新）

灰太狼 2021-05-10 11:18 398阅读 0赞

> 阿里云通信（原名阿里大于）的短信服务（Short Message Service）是阿里云为用户提供的一种通信服务的能力，支持快速发送短信验证码、短信通知等。 完美支撑双11期间2亿用户，发送6亿短信。三网合一专属通道，与工信部携号转网平台实时互联。电信级运维保障，实时监控自动切换，到达率高达99%。

具体阿里大于是什么时候改版到阿里云通信的，不是太清楚，反正以前的短信发送验证码、短信通知的接口最近用不了了（提示的错误见下面的日志），于是只能根据阿里云通信提供的API对接口重新改版。

ERROR com.taobao.api.internal.util.TaobaoLogger: 2017-12-08 12:09:52.181^_^LTAIR3x1VogOJPz5^_^alibaba.aliqin.fc.sms.num.send^_^172.19.38.254^_^Windows Server 2012 R2^_^46^_^http://gw.api.taobao.com/router/rest^_^^_^{
       "error_response":{
       "code":11,"msg":"Insufficient isv permissions","sub_code":"isv.permission-api-package-limit","sub_msg":"scope ids is 11022 11600 11863","request_id":"rxn0ipvhba2f"}}

发现错误后的第一反应当然是根据错误信息去找原因：

Insufficient isv permissions：开发者权限不足  
isv.permission-api-package-limit：没有和任何访问包关联，建议根据业务规则申请对应的权限

这样的解释似乎并不能帮助我们解决掉问题？

接下来的做法，当然是去看阿里云通信官方给出的API，等待把Java版的短信产品相关的SDK及DEMO程序下载到本地后，我明白了。

新的jar包

> aliyun-java-sdk-core-3.3.1.jar  
> aliyun-java-sdk-dysmsapi-1.0.0.jar

原来调用的jar包

> taobao-sdk-java-auto\_1455552377940-20160607.jar

sdk已经发生了变化，当然旧版的短信接口99%是用不了的。

那么新版的阿里云通信短信发送API该怎么调用呢？

1）创建阿里云账号

2）获取阿里云访问密钥

![这里写图片描述][SouthEast]

3）在控制台完成模板与签名的申请，获得调用接口必备的参数

![这里写图片描述][SouthEast 1]

添加模板的时候，请一定要注意，模板的格式是需要一定规则的，后面编写Java代码时需要进行匹配，举例如下：

![这里写图片描述][SouthEast 2]

`${code}`在后面调用阿里云API的时候要传递。

![这里写图片描述][SouthEast 3]

`${username}`和`${password}`同样在后面调用阿里云API的时候要传递。

模板提交后，阿里云通信会在2个小时候内审批，审批完成后就可以看到模板CODE，该参数在后面调用API的时候同样是必须的。

4）下载Java版的SDK

如果你使用的是maven，阿里提供的方式是：

如果你们公司有自己搭建仓库，可以把SDK里面提供的本地jar上传上去即可
    或者你走你的本地jar依赖方式
    
    <dependency>
    <groupId>*</groupId>
    <artifactId>*</artifactId>
    <version>*</version>
    <systemPath>${project.basedir}/lib/*.jar</systemPath>
    </dependency>
    <scope> compile</scope>

如果是常规的Java或者Javaweb项目（直接放在WEB-INF的lib包下），则可以把以下两个jar包引入到工程当中：

> aliyun-java-sdk-core-3.3.1.jar  
> aliyun-java-sdk-dysmsapi-1.0.0.jar

5）编写发送短信的util类

package com.honzh.common.util;
    
    import java.text.SimpleDateFormat;
    import java.util.Date;
    
    import com.aliyuncs.DefaultAcsClient;
    import com.aliyuncs.IAcsClient;
    import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsRequest;
    import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsResponse;
    import com.aliyuncs.dysmsapi.model.v20170525.SendSmsRequest;
    import com.aliyuncs.dysmsapi.model.v20170525.SendSmsResponse;
    import com.aliyuncs.exceptions.ClientException;
    import com.aliyuncs.profile.DefaultProfile;
    import com.aliyuncs.profile.IClientProfile;
    import com.honzh.common.sys.OrderException;
    
    public class MoblieMessageUtil { 
    
        // 产品名称:云通信短信API产品,开发者无需替换
        private static final String product = "Dysmsapi";
        // 产品域名,开发者无需替换
        private static final String domain = "dysmsapi.aliyuncs.com";
    
        // 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
        private static String accessKeyId = "yourAccessKeyId";
        private static String accessKeySecret = "yourAccessKeySecret";
        private static String signName = "yourAccessKeySecret";
        private static String identifyingTempleteCode = "yourAccessKeySecret";
        private static String registTempleteCode = "yourAccessKeySecret";
    
        public static void init(String accessKeyId, String accessKeySecret, String signName, String identifyingTempleteCode,
                String registTempleteCode) {
            MoblieMessageUtil.accessKeyId = accessKeyId;
            MoblieMessageUtil.accessKeySecret = accessKeySecret;
            MoblieMessageUtil.signName = signName;
            MoblieMessageUtil.identifyingTempleteCode = identifyingTempleteCode;
            MoblieMessageUtil.registTempleteCode = registTempleteCode;
        }
    
        public static void main(String[] args) {
            MoblieMessageUtil.init("key", "keysecret", "沉默王二", "SMS_110",
                    "SMS_112");
            // 发短信
            SendSmsResponse response = MoblieMessageUtil.sendIdentifyingCode("手机号", "123456");
            System.out.println("短信接口返回的数据----------------");
            System.out.println("Code=" + response.getCode());
            System.out.println("Message=" + response.getMessage());
            System.out.println("RequestId=" + response.getRequestId());
            System.out.println("BizId=" + response.getBizId());
    
            response = MoblieMessageUtil.sendNewUserNotice("18637903705", "123456", "4512");
            System.out.println("短信接口返回的数据----------------");
            System.out.println("Code=" + response.getCode());
            System.out.println("Message=" + response.getMessage());
            System.out.println("RequestId=" + response.getRequestId());
            System.out.println("BizId=" + response.getBizId());
    
        }
    
        public static SendSmsResponse sendSms(String mobile, String templateParam, String templateCode)
                throws ClientException {
    
            // 可自助调整超时时间
            System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
            System.setProperty("sun.net.client.defaultReadTimeout", "10000");
    
            // 初始化acsClient,暂不支持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();
    
            // 必填:待发送手机号
            request.setPhoneNumbers(mobile);
            // 必填:短信签名-可在短信控制台中找到
            request.setSignName(signName);
            // 必填:短信模板-可在短信控制台中找到
            request.setTemplateCode(templateCode);
    
            // 可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
            request.setTemplateParam(templateParam);
    
            // 选填-上行短信扩展码(无特殊需求用户请忽略此字段)
            // request.setSmsUpExtendCode("90997");
    
            // 可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
            request.setOutId("yourOutId");
    
            // hint 此处可能会抛出异常，注意catch
            SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
    
            return sendSmsResponse;
        }
    
        public static SendSmsResponse sendNewUserNotice(String mobile, String username, String password) {
            try {
                return sendSms(mobile, "{\"username\":\"" + username + "\", \"password\":\"" + password + "\"}",
                        registTempleteCode);
            } catch (ClientException e) {
                throw new OrderException(e.getMessage());
            }
        }
    
        public static SendSmsResponse sendIdentifyingCode(String mobile, String code) {
            try {
                return sendSms(mobile, "{\"code\":\"" + code + "\"}", identifyingTempleteCode);
            } catch (ClientException e) {
                throw new OrderException(e.getMessage());
            }
        }
    }

API的调用方式是阿里云提供的，不过这里需要注意的是参数的json字符串一定要正确。

上文中验证码模板的参数格式是`{"code":"123456"}`，尽管123456是数字，也要按照字符串传递。  
注册模板的参数格式是“\`\{“username”:”沉默王二”,”password”:”123456”\}。

另外，模板CODE一定要传递正确！一般是以SMS\_开头的，例SMS\_113121051

--------------------

> 我的成功，需要你的一臂之力！
> 
> ![20161224204853903][]

[SouthEast]: /images/20210506/e0a08ba7ce3a466ab23eb1d608fc750c.png
[SouthEast 1]: /images/20210506/d408f9cb3fa447089d69f5c73ea94a26.png
[SouthEast 2]: /images/20210506/c3a5339b5ac040bc8aa219665da0cfcd.png
[SouthEast 3]: /images/20210506/f29d65dc04a7499591532abeab87d775.png
[20161224204853903]: /images/20210506/c2f1a7aa8b0e405c9debae4442734631.png