Django集成云片网实现手机验证码发送功能详解

Noah
Noah
发布时间:2026-10-13 | 4人浏览过
原创

本文详细介绍如何在Django项目中集成云片网短信API实现手机验证码发送功能。内容涵盖前后端交互流程、云片网后台配置(签名模板审核、IP白名单)、Python发送脚本编写以及Django视图与URL配置。同时指出后端应增加防刷机制、验证码有效期及重复发送限制等优化建议,帮助开发者快速落地短信验证模块。

一、流程分析:

1. 用户在前端页面输入手机号,点击【获取验证码】按钮,通过POST请求将手机号发送至后台接口。

2. 后台接收请求后,首先校验手机号格式是否合法以及该号码是否已被占用。若验证通过,则生成随机验证码,调用脚本接口通知短信运营商向该手机号发送验证码;若验证失败,则直接返回错误提示信息。

3. 用户收到短信验证码后,再次将所有相关数据通过POST请求提交至后台。

4. 后台对提交的数据进行二次校验,若所有数据验证通过,则完成实名制认证流程;若未通过,则返回相应的错误信息。

总结:一次完整的实名验证流程涉及两次Ajax POST请求交互。

二、对接短信商:

1. 云片网平台配置:

1. 注册云片网账号

注册地址:https://www.yunpian.com/

登录后台管理控制台,其中最重要的配置信息是APIKEY。

2. 完成开发者备案、新增签名以及新增短信模板(在模板管理中操作)。

1. 云片网后台提供的【测试】功能实际上只是向指定手机发送一条短信,这并不具备真正的测试意义。

2. 在【签名/模板设备】页面的【签名管理】中点击【新增签名】时,系统会提示完善【开发者信息】。认证类型分为【公司】和【个人】两种,目前处于开发测试阶段,可选择【个人】认证,需上传身份证照片进行提交。

3. 等待认证完成的短信通知,随后按照后台操作指引,在【签名管理】页【新增签名】,并在【模板管理】页【新增模板】。这些操作均需等待云片网审核,审核通过后会有短信通知。

4. 在云片网后台设置IP白名单,将服务器外网IP加入白名单列表。

获取本机外网IP最简单的方法是直接在百度搜索“ip”。

2. 在Django项目中编写发送短信的脚本。

在项目目录下新建utils目录,并在其中新建yunpian.py文件。

import requests
class YunPian(object):
  def __init__(self,api_key):
    self.api_key=api_key
    self.single_send_url='https://sms.yunpian.com/v2/sms/single_send.json'

  def send_sms(self,code,mobile):
    parmas={
      'apikey':self.api_key,
      'mobile':mobile,
      'text':'【**网】您的验证码是[code]。如非本人操作,请忽略本短信'.format(code=code)
    }
    #text必须要跟云片后台的模板内容 保持一致,不然发送不出去!
    r=requests.post(self.single_send_url,data=parmas)
    print(r)

if __name__=='__main__':
  yun_pian=YunPian('***************(你的apikey)')
  yun_pian.send_sms('***(验证码)','*******(手机号)')

三、在项目中编写发送手机验证码相关代码:

1. 前端相关代码实现:

<!--发送按钮倒计时代码-->
<script type="text/javascript">
var countdown=60;
function settime(obj) {
  if (countdown == 0) {
    obj.removeAttribute("disabled");
    obj.value="免费获取验证码";
    countdown = 60;
    return;
  } else {
    obj.setAttribute("disabled", true);
    obj.value="重新发送(" + countdown + ")";
    countdown--;
  }
setTimeout(function() {
  settime(obj) }
  ,1000)
}

</script>


<!--手机号码输入框代码-->

<div class="form-group">
          <label for="mobile" class="col-lg-2 col-sm-2 control-label">手机号码:</label>
          <div class="col-lg-10">
            <div class="input-group m-bot15">
          <input type="text" class="form-control" id="mobile" name="mobile" placeholder="手机号码">
          <span class="input-group-btn">
             <input type="button" id="forcode" onclick="settime(this)" value="免费获取验证码" class="btn btn-success">
          </span>
            </div>
          <p class="help-block">请填写绑定手机号</p>
          </div>
        </div>


<!--向后台通过ajax发送手机号码数据-->
<script>
  $('#forcode').click(function () {
    $.ajax({
      cache:false,
      type:"POST",
      url:"{% url 'users:forcode' %}",
      data:{
        csrfmiddlewaretoken:$('[name="csrfmiddlewaretoken"]').val(),
        mobile:$("#mobile").val()
      },
      async:true,
      success:function (data) {
        alert(data)
      }
    })
  })
</script>

效果图展示:

2. 在users/views.py中编写发送验证码相关的视图代码:

import re
import random
from xyw.settings import APIKEY
from .models import VerifyCode


class ForCodeView(View):
  """获取手机验证码"""
  def post(self,request):
    mobile=request.POST.get('mobile','')
    if mobile:
      #验证是否为有效手机号
      mobile_pat=re.compile('^(13\d|14[5|7]|15\d|166|17\d|18\d)\d{8}$')
      res=re.search(mobile_pat,mobile)
      if res:
        #生成手机验证码
        code=VerifyCode()
        code.mobile=mobile
        c=random.randint(1000,9999)
        code.code=str(c)
        code.save()
        code=VerifyCode.objects.filter(mobile=mobile).first().code
        yunpian=YunPian(APIKEY)
        sms_status=yunpian.send_sms(code=code,mobile=mobile)
        msg=sms_status.msg
        return HttpResponse(msg)
      else:
        msg='请输入有效手机号码!'
        return HttpResponse(msg)
    else:
      msg='手机号不能为空!'
      return HttpResponse(msg)

3. 在users/urls.py中进行路由配置:

from .views import ForCodeView
......

urlpatterns = [

  ......
  path('forcode/',ForCodeView.as_view(),name='forcode'),
]

4. 在settings.py中增加相关配置代码:

#云片网apikey
APIKEY=‘你云片网的apikey'

至此,发送手机验证码的功能已实现。

实际上还有可以优化的地方:

1. 虽然前端设置了60秒倒计时限制才能重新发送,但后端也应添加相应的频率限制验证,以防被恶意利用。

2. 当前逻辑未验证手机号码是否已经发送过验证码。

3. 验证码缺乏生命周期管理,应设置一定时间后让验证码自动失效。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表