微信小程序 获取 手机验证码 短信验证码 后端功能实现解析

发表于 作者 jiukeshuju

实现过程如下

  1. 腾讯云中创建短信签名、创建短信正文模板，人工审核
  2. 使用Java SDK调用短信发送API接口
  3. 短信发送成功

（因为客户要求使用腾讯云服务器，所以我这里用腾讯云为例） 

第一步：创建短信签名、创建短信正文模板

首先理解一下相关概念：

短信签名

短信签名是位于短信正文前【】中的署名，用于标识公司或业务，例如【腾讯科技】。申请时企业用户需要上传资质证明，个人用户需要上传个人身份证明。短信签名需要审核通过后才可使用。
签名示例：
认证企业为：深圳市腾讯计算机系统有限公司，可以申请与企业名相关的签名【腾讯科技】，也可以申请公司旗下的产品名称相关的签名【微信】、【腾讯云】等。

简而言之，如果短信内容为：

【腾讯科技】您的QQ登录验证码是1234，5分钟内有效。

那么，短信签名就是——腾讯科技。这样看懂了吧？

短信模板

短信模板即具体发送的短信正文内容，短信模板支持验证码模板、通知类短信模板和营销短信模板。短信内容可以通过模板参数实现个性化定制。

如果短信内容为：

腾讯科技需要发送短信验证码：【腾讯科技】您的QQ登录验证码是1234，2分钟内有效。

那么，短信模板就是：您的QQ登录验证码是{1}，{2}分钟内有效。
模板参数中{1}，{2}是变量，且按序排列，他们的值可以在实际下发时通过设置模板参数的值来自定义。

为了避免开发者滥发短信，所以短信签名、短信模板需要腾讯云进行人工审核，具体操作如下：

打开腾讯云官网，进入右上角控制台，进入短信界面，然后创建签名。

然后同样的方法，创建短信模板

接着就是人工审核，大概10分钟左右就够了。

第二步：使用Java SDK调用短信发送API接口

所谓使用SDK，也就是说，腾讯已经给你写好发送短信的API接口，连调用API接口的模板都给你写好了，你只要拿来用就可以。

SDK下载地址（Github）：https://github.com/TencentCloud/tencentcloud-sdk-java

当然这个SDK里面所有功能都实现了，比如发送短信，群发短信，拉取回执状态，统计短信发送数据，包括国内的，境外的，全都有。但是功能多，导包的时间也长，而我们只需要发送国内短信即可，所以我自己把他精简了一下，因为我这里只需要发送短信的功能。

我这里以IDEA为例，打开IDEA，新建一个MAVEN项目

勾上Create from archetype

选择org.apache.maven.archetypes:maven-archetype-webapp

添加属性

name：archetypeCatalog，value：internal

为什么要这么做？是因为系统默认从Maven获取依赖，但是很慢，我们可以选择从本地导入，这样基本不需要时间，达到快速创建项目的效果。 

创建完Maven项目，只需要修改两个文件

1.pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>yanzhengma</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
        <java.version>11</java.version>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.github.qcloudsms</groupId>
            <artifactId>qcloudsms</artifactId>
            <version>1.0.6</version>
        </dependency>
    </dependencies>
</project>

2.随意包下的Main函数

import com.github.qcloudsms.SmsSingleSender;
import com.github.qcloudsms.SmsSingleSenderResult;
import com.github.qcloudsms.httpclient.HTTPException;
import org.json.JSONException;
import java.io.IOException;
public class Main {
    public static void main(String[] args) {
        // 短信应用 SDK AppID
        int appid = 1400xxxx84; // SDK AppID 以1400开头
        // 短信应用 SDK AppKey
        String appkey = "d4e5bxxxxxxxxxx02c907501b4ee8645";
        // 需要发送短信的手机号码
        String[] phoneNumbers = {"178xxxxxx85"};
        // 短信模板 ID，需要在短信应用中申请
        int templateId = 60xxx8; // NOTE: 这里的模板 ID`7839`只是示例，真实的模板 ID 需要在短信控制台中申请
        // 签名
        String smsSign = "XXXX"; // NOTE: 签名参数使用的是`签名内容`，而不是`签名ID`。这里的签名"腾讯云"只是示例，真实的签名需要在短信控制台申请
        try {
            String[] params = {"5678","5"};
            SmsSingleSender ssender = new SmsSingleSender(appid, appkey);
            SmsSingleSenderResult result = ssender.sendWithParam("86", phoneNumbers[0],
                    templateId, params, smsSign, "", "");
            System.out.println(result);
        } catch (HTTPException e) {
            // HTTP 响应码错误
            e.printStackTrace();
        } catch (JSONException e) {
            // JSON 解析错误
            e.printStackTrace();
        } catch (IOException e) {
            // 网络 IO 错误
            e.printStackTrace();
        }
    }
}

还有要这四个jar包

我们就像Java运行Hello World那样，运行一下主函数，短信就发出来了

接下来来解析一下代码：

1.短信账号，密匙

int appid = 1400xxxx84;
String appkey = "d4e5bxxxxxxxxxx02c907501b4ee8645";

类似微信小程序，appid是账号，appkey是密匙，我们在腾讯云控制台获取。

点进去可以查看appkey。

2.需要发送的手机号 

String[] phoneNumbers = {"178xxxxxx85"};

3.短信模板ID

int templateId = 60xxx8;

在第一步的 国内短信 —— 签名管理 中 查看ID。

4.签名

String smsSign = "XXXX";

同短信模板，你申请的是什么签名，这里就写什么，比如“腾讯科技”

5.填入参数

String[] params = {"5678","5"};

在第一步中，介绍了短信模板的概念

短信模板就是：您的QQ登录验证码是{1}，{2}分钟内有效。 

其中这个{1}，类似SQL中的预编译，这里有几个参数，这个params数组就几个元素。

短信发出去就是——您的QQ登录验证码是5678，5分钟内有效。 

以上数据全部替换后，执行Main主函数就可以，短信就发出来了

这就是微信小程序中，实现短信验证码登入的后端操作，时间有限，我只是简单写了一下，还有更多功能，我会在后续继续深入研究。

发表评论