短信---阿里大鱼

时间：2022-09-25 20:45:32

注意导包 ，测试成功。 作为纪念（使用的是大众版 阿里大鱼）

发送短信接口(SendSms)
步骤 1 创建阿里云账号
为了访问短信服务，您需要有一个阿里云账号。如果没有，可首先按照如下步骤创建阿里云账号：

访问阿里云 官方网站，单击页面上的 免费注册 按钮。
按照屏幕提示完成注册流程并进行实名认证，短信服务只支持实名认证用户使用。为了更好地使用阿里云服务，建议尽快完成实名认证，否则部分阿里云服务将无法使用。具体实名认证流程，请参考 这里。
步骤 2 获取阿里云访问密钥
为了使用短信发送API-JAVA SDK，您必须申请阿里云的访问密钥。

阿里云访问秘钥是阿里云为用户使用 API（非控制台）来访问其云资源设计的“安全口令”。您可以用它来签名 API 请求内容以通过服务端的安全验证。

该访问秘钥成对（AccessKeyId 与 AccessKeySecret）生成和使用。每个阿里云用户可以创建多对访问秘钥，且可随时启用（Active）、禁用（Inactive）或者删除已经生成的访问秘钥对。

您可以通过阿里云控制台的 秘钥管理页面 创建、管理所有的访问秘钥对，且保证它处于“启用”状态。由于访问秘钥是阿里云对 API 请求进行安全验证的关键因子，请妥善保管你的访问秘钥。如果某些秘钥对出现泄漏风险，建议及时删除该秘钥对并生成新的替代秘钥对。

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

根据用户属性来创建符合自身属性的签名信息。企业用户需要上传相关企业资质证明，个人用户需要上传证明个人身份的证明。

注意：短信签名需要审核通过后才可以使用。

短信模板

短信模板，即具体发送的短信内容。

短信模板可以支持验证码、短信通知、推广短信、国际/港澳台消息四种模式。验证码和短信通知，通过变量替换实现个性短信定制。推广短信不支持在模板中添加变量。

短信模板需要审核通过后才可以使用。

为了成功发送一条短信通知，您至少需要完成以下步骤

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

在“短信签名”页面完成签名的申请，获得短信签名的字符串 签名申请手册

在“短信模板”页面完成模板的申请，获得模板ID。模板申请手册

参数
入参列表
参数名称 参数类型 必填与否 样例取值 参数说明
PhoneNumbers String 必须 15000000000 短信接收号码,支持以逗号分隔的形式进行批量调用，批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式；发送国际/港澳台消息时，接收号码格式为00+国际区号+号码，如“0085200000000”
SignName String 必须 云通信 短信签名
TemplateCode String 必须 SMS_0000 短信模板ID
TemplateParam String 可选 {“code”:”1234”,”product”:”ytx”} 短信模板变量替换JSON串,友情提示:如果JSON中需要带换行符,请参照标准的JSON协议。
SmsUpExtendCode String 可选 90999 上行短信扩展码,无特殊需要此字段的用户请忽略此字段
OutId String 可选 abcdefgh 外部流水扩展字段
出参列表
出参名称 出参类型 样例取值 参数说明
RequestId String 8906582E-6722 请求ID
Code String OK 状态码-返回OK代表请求成功,其他错误码详见错误码列表
Message String 请求成功 状态码的描述
BizId String 134523^4351232 发送回执ID,可根据该ID查询具体的发送状态

package test;
 import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
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;
/** * * @author Lsc * */
public class SMSSender {
    //产品名称:云通信短信API产品,开发者无需替换 固定除非阿里那边更改 注意版本 目前作者使用的是v20170525 之前的版本是Sms
    static final String product = "Dysmsapi";
    //产品域名,开发者无需替换 固定除非阿里那边更改 注意版本 目前作者使用的是v20170525 之前的版本是sms.aliyuncs.com
    static final String domain = "dysmsapi.aliyuncs.com";
    //开发者自己的AK(在阿里云访问控制台寻找) 阿里给你的秘钥对
    static final String accessKeyId = "XXXXXXX";
    static final String accessKeySecret = "XXXXXXX";

    //短信模板审核通过平台会给你一个code 或者自己申请的模板CODE
    public static final String TEMPLATE_CODE_NOTIFY = "SMS_112635023"; 
    public static final String[] TEMPLATE_CODES = {
            TEMPLATE_CODE_NOTIFY
    };

    /**发送短信 * @param templateCode * @param phones * @param verify * @return * @throws ClientException */
    public static SendSmsResponse sendSms(String templateCode, String phones, String key, String value) throws ClientException {

        //可自助调整超时时间
        System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
        System.setProperty("sun.net.client.defaultReadTimeout", "10000");

        //初始化acsClient,暂不支持region化 
        //region一般为cn-hangzhou但也有其他区域的 具体请去看API或者网上自行搜索
        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(phones);
        //必填:短信签名-可在短信控制台中找到
        request.setSignName("公司名字");
        //必填:短信模板-可在短信控制台中找到
        request.setTemplateCode(templateCode);
        //可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},欢迎来到..."
        //key是短信模板中的变量名 value就是变量值 eg：key=>name value=>小明
        String paramString="{\"name\":\"lsc\",\"address\":\"天上人间\",\"fee\":\"500000000\",\"pay\":\"100000000\"}";
        request.setTemplateParam(paramString);

        //选填-上行短信扩展码(无特殊需求用户请忽略此字段) 
        //request.setSmsUpExtendCode("90997");

        //可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者,可以自定义
        request.setOutId("此参数自己设置 并可以自发送成功后返回到你自己服务器 用来做特殊业务 自行选择");

        //hint 此处可能会抛出异常，注意catch
        SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
        if (sendSmsResponse != null) {
            System.out.println("短信接口返回的数据----------------");
            System.out.println("Code="+sendSmsResponse.getCode());
            System.out.println("Message="+sendSmsResponse.getMessage());
            System.out.println("RequestId="+sendSmsResponse.getRequestId());
            System.out.println("BizId="+sendSmsResponse.getBizId());
        }

        return sendSmsResponse;
    }

    public static void main(String[] args) {
        try {
            SendSmsResponse smsResponse = sendSms(SMSSender.TEMPLATE_CODES[0], "1534830xxxx", "1111", "一只特立独行的研究者");
            if (smsResponse != null) {
                System.out.println("短信接口返回的数据----------------");
                System.out.println("Code="+smsResponse.getCode());
                System.out.println("Message="+smsResponse.getMessage());
                System.out.println("RequestId="+smsResponse.getRequestId());
                System.out.println("BizId="+smsResponse.getBizId());
            }
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}


标签：

相关文章