验证码短信 API 接入指南：Java 语言示例代码

Posted 2023-05-08 smartgirlintown

短信验证码是一种通过短信发送的验证码，通常用于验证用户的身份、保障账户安全和防止恶意攻击等。短信验证码已经成为现代社会中不可或缺的一部分，广泛应用于各种场景，包括用户注册和登录、找回密码等等。

为了满足企业在账户安全验证和业务发展方面的需求，验证码短信 API 应运而生，它可以帮助企业快速、便捷地发送和验证短信验证码，同时提高账户安全性和用户体验，让企业在市场竞争中脱颖而出。

验证码短信应用场景分析

短信验证码是一种非常常见的验证方式，可以通过短信将随机生成的验证码发送到用户手机上进行验证。在不同的业务场景中，短信验证码可以应用于多种验证场景，以下是几个典型的应用场景：

1. 手机注册

在移动互联网时代，手机注册已经成为了非常常见的一种注册方式。在用户注册时，需要输入手机号码，并且通过短信验证码验证手机号的真实性，避免恶意注册和虚假信息，保证用户信息的真实性和安全性。

2. 找回密码

当用户忘记密码时，可以通过手机号码获取验证码进行验证，然后通过输入验证码来重置密码。这种方式比传统的找回密码方式更加简单和快捷，可以提高用户的使用体验。

3. 支付验证

在支付宝、微信支付等支付场景中，需要通过短信验证码来保证交易的安全性和可靠性，避免不法分子盗用用户账号进行欺诈和非法交易。

4. 更改信息

用户更改注册管理重要信息的时候，通过填入手机验证码，一键操作，安全提供便捷。

验证码短信 API 的技术原理

验证码短信 API 通过与运营商网关通信，将验证码短信快速、可靠地发送到用户手机，从而提高了验证的安全性和可靠性，其工作原理如下：

验证码短信 API 接入指南

验证码短信 API 通过与运营商网关通信，实现了将验证码短信快速、可靠地发送到用户手机的功能，下面是一个Java 语言接入的示例代码，更多的语言示例代码可以参考【接入指南】。

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, ""msg":"【Eolinker】您的验证码是：$var，5分钟内有效。如非本人操作，请忽略。","params":"15800000000,1234;13800000000,4321","sendtime":"","extend":"","uid":""");
Request request = new Request.Builder()
  .url("https://eolink.o.apispace.com/sms-code/verifycode")
  .method("POST",body)
  .addHeader("X-APISpace-Token","使用平台提供的API 密钥")
  .addHeader("Authorization-Type","apikey")
  .addHeader("Content-Type","application/json")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

注意：API 密钥需要通过 APISpace 等网站注册登录获取。

结语

总之，验证码短信 API 已经成为现代社会中不可或缺的一部分，可以广泛应用于各种场景，包括用户注册和登录、找回密码、支付验证等等。通过接入验证码短信 API，企业可以快速、便捷地发送和验证短信验证码，提高账户安全性和用户体验，让企业在市场竞争中脱颖而出，有需要的赶紧用起来吧~

APP网站等注册登录改密等发送验证码短信的接入流程

1.登录 https://zz.253.com/site/login.html
2.获取接口API账号，密码：选择任意产品>激活>企业认证（上传公司营业执照）
3.申请签名（以公司简称或缩写命名）备注：平台申请签名，API接口加上申请签名
4.模板申请（自定义编辑内容）：选择任意应用>短息编辑栏目{模板管理}>添加签名
4.sms_send_demo.php发送短信
sms_queryBalance_demo.php查询短信余额
备注：申请模板可达到短信免审作用

常见问题
1.相同号码一天有10条限制（可根据业务需求进行调整）
2.接口账号（使用API账号，密码 并非登录管理后台账号，密码）

状态报告接入流程：
1.配置一个外网可以访问的URL来接受创蓝服务器的异步推送
2.参考receive.php

主要代码：
<?php
header("Content-type:text/html; charset=UTF-8");

class ChuanglanSmsApi {

    //发送短信的接口地址
    const API_SEND_URL=‘http://sms.253.com/msg/send?‘;

    //查询余额的接口地址
    const API_BALANCE_QUERY_URL=‘http://sms.253.com/msg/balance?‘;

    const API_ACCOUNT=‘*******‘;//短信账号从 https://zz.253.com/site/login.html 里面获取。

    const API_PASSWORD=‘*******‘;//短信密码从 from https://zz.253.com/site/login.html 里面获取。

    /**
     * 发送短信需要的接口参数
     *
     * @param string $mobile                 手机号码
     * @param string $msg                         想要发送的短信内容
     * @param string $needstatus         是否需要状态报告 ‘1‘为需要 ‘0‘位不需要。
     */
    public function sendSMS( $mobile, $msg, $needstatus = 1) {

            //发送短信的接口参数
            $postArr = array (
                                      ‘un‘ => self::API_ACCOUNT,
                                      ‘pw‘ => self::API_PASSWORD,
                                      ‘msg‘ => $msg,
                                      ‘phone‘ => $mobile,
                                      ‘rd‘ => $needstatus
                 );

            $result = $this->curlPost( self::API_SEND_URL , $postArr);
            return $result;
    }

    /**
     * 
     *
     *  查询余额
     */
    public function queryBalance() {

            // 查询接口参数
            $postArr = array ( 
                      ‘un‘ => self::API_ACCOUNT,
                      ‘pw‘ => self::API_PASSWORD,
            );
            $result = $this->curlPost(self::API_BALANCE_QUERY_URL, $postArr);
            return $result;
    }

    /**
     * 处理接口返回值
     * 
     */
    public function execResult($result){
            $result=preg_split("/[,\r\n]/",$result);
            return $result;
    }

    /**
     * @param string $url  
     * @param array $postFields 
     * @return mixed
     */
    private function curlPost($url,$postFields){
            $postFields = http_build_query($postFields); 
            if(function_exists(‘curl_init‘)){

                    $ch = curl_init ();
                    curl_setopt ( $ch, CURLOPT_POST, 1 );
                    curl_setopt ( $ch, CURLOPT_HEADER, 0 );
                    curl_setopt ( $ch, CURLOPT_RETURNTRANSFER, 1 );
                    curl_setopt ( $ch, CURLOPT_URL, $url );
                    curl_setopt ( $ch, CURLOPT_POSTFIELDS, $postFields );
                    $result = curl_exec ( $ch );
                    if(curl_errno($ch))
                    {
                            return ‘Curl error: ‘ . curl_error($ch);
                    }
                    curl_close ( $ch );
            }elseif(function_exists(‘file_get_contents‘)){

                    $result=file_get_contents($url.$postFields);

            }
            return $result;
    }

    //魔术获取
    public function __get($name){
            return $this->$name;
    }

    //魔术设置
    public function __set($name,$value){
            $this->$name=$value;
    }

}
?>