短信API——短信驗證碼

簡介

• 短信服務（Short Message Service、SMS）是指經過調用短信發送API，將指定短信內容發送給指定手機用戶。

阿里雲短信服務

• 阿里雲短信服務產品介紹：https://www.aliyun.com/product/sms
• 短信發送API幫助文檔(Java)：https://help.aliyun.com/document_detail/55284.html

發送短信(發送驗證碼)

• 須要如下配置
  • 購買產品後，後臺分配的accessKeyId、accessKeySecret
  • 本身配置的短信模板ID（如：SMS_45680123）
  • 模板變量（若是模板中存在變量）
• 下載官方SDK：https://help.aliyun.com/document_detail/55359.html
  • 不支持迅雷等工具進行下載
  • 解壓後包含文件夾：api_demo、api_sdk、msg_demo、msg_sdk。只需關注api的兩個文件夾
• 使用sdk
  • 直接導入jar包：取api_demo/alicom-dysms-api/libs裏面的aliyun-java-sdk-core-3.2.3.jar和aliyun-java-sdk-dysmsapi-1.0.0.jar便可

  • 使用maven：走本地jar，如：

    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-core</artifactId>
        <version>3.2.3</version>
                    <scope>system</scope>
        <systemPath>${basedir}/src/main/resources/lib/aliyun-java-sdk-core-3.2.3.jar</systemPath>
    </dependency>
    
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-dysmsapi</artifactId>
        <version>1.0.0</version>
                    <scope>system</scope>
        <systemPath>${basedir}/src/main/resources/lib/aliyun-java-sdk-dysmsapi-1.0.0.jar</systemPath>
    </dependency>

• 示例

  public static Boolean send(String telphone, String code) throws Exception {
      //設置超時時間-可自行調整（指鏈接服務器超時時間）
      System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
      System.setProperty("sun.net.client.defaultReadTimeout", "10000");
      //初始化ascClient須要的幾個參數
      final String product = "Dysmsapi";//短信API產品名稱（短信產品名固定，無需修改）
      final String domain = "dysmsapi.aliyuncs.com";//短信API產品域名（接口地址固定，無需修改）
      // TODO 替換成你的AK
      final String accessKeyId = "LTAIzIZWzVeeeqqqe";//你的accessKeyId,參考本文檔步驟2
      final String accessKeySecret = "bnLKDS4LErpgLqwersdfwewe4SWEEd";//你的accessKeySecret，參考本文檔步驟2
      //初始化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個手機號碼,批量調用相對於單條調用及時性稍有延遲,驗證碼類型的短信推薦使用單條調用的方式
      request.setPhoneNumbers(telphone);
      // TODO 必填:短信簽名-可在短信控制檯中找到
      request.setSignName("隨便，客戶看不到");
      // TODO 必填:短信模板-可在短信控制檯中找到
      request.setTemplateCode("SMS_23680123");
      //TODO 可選:模板中的變量替換JSON串,如模板內容爲"親愛的${name},您的驗證碼爲${code}"時,此處的值爲
      //友情提示:若是JSON中須要帶換行符,請參照標準的JSON協議對換行符的要求,好比短信內容中包含\r\n的狀況在JSON中須要表示成\\r\\n,不然會致使JSON在服務端解析失敗
      request.setTemplateParam(String.format("{\"code\":\"%s\"}", code));
      //可選-上行短信擴展碼(無特殊需求用戶請忽略此字段)
      //request.setSmsUpExtendCode("90997");
      //可選:outId爲提供給業務方擴展字段,最終在短信回執消息中將此值帶回給調用者
      request.setOutId("yourOutId");
      //請求失敗這裏會拋ClientException異常
      SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
      if(sendSmsResponse.getCode() != null && sendSmsResponse.getCode().equals("OK")) {
          //請求成功
          return true;
      } else {
          logger.error("code: {}, message: {}", sendSmsResponse.getCode(), sendSmsResponse.getMessage());
      }
  
      return false;
  }

  • 其中模板中的${code}即爲隨機生成的驗證碼，將此驗證碼發送到用戶手機，並將此驗證碼和其過時時間一塊兒保存到session中供提交驗證