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

作者: jiukeshuju 分类: 小程序 发布时间: 2021-05-30 10:10

实现过程如下

  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主函数就可以,短信就发出来了

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





如果觉得我的文章对您有用,请随意赞赏。您的支持将鼓励我继续创作!

发表评论