一、发送验证码接口准备
1.发送验证码接口准备
手机短信发送----》第三方短信平台(阿里大于短信,腾讯云短信)
腾讯云短信平台:https://console.cloud.tencent.com/smsv2/guide
# 快速入门
创建短信签名
-申请一个公众号---》个人公众号(微信公众号扫码注册)
创建短信正文模板
-审核
等待审核
发送短信
2.API和SDK的区别
API:就是一个个接口 http:/asdfasdf/ http接口
麻烦,需要分析接口的请求参数和返回参数---》但是通用,有的厂商不提供sdk,只能用API接口
SDK:集成开发工具包,跟语言有关系,有的厂商不提供python的sdk,不同语言对api的封装,更方便的使用提供的服务
腾讯云短信的sdk
-老版本:2.0 :只针对于发短信( pip install qcloudsms_py):https://cloud.tencent.com/document/product/382/11672
-新版本:3.0:不仅仅针对于发短信(pip install tencentcloud-sdk-python):https://cloud.tencent.com/document/product/382/43196
实际工作中遇到的问题
注意:python3.8以上,sdk2.0用起来会有问题,用了内置的json模块,json模块一直在改
json:python3.6以前是不能序列化bytes格式的,必须是字符串才能序列化成列表,但到了python3.6可以直接bytes序列化json.loads
到了python 3.9又改了一个东西,由于之前使用的json模块没有动,到了3.8以后,json模块改了,他的代码没有改,到了3.8以后,发送短信会报错。
用了第三方模块,它的新版本已经开始用了,随着python解释器的升级,老版本用不了了,排查了一下,就是因为内部用了json模块,json模块升级了之后,导致老版本永不了了。
二、腾讯云发送短信二次封装
libs/sms/settings.py
APP_ID = '1400637895'
APP_KEY = '8ab006fe2bb591c2aa6735a90fae27d2'
TEMPLATE_ID = '1313582'
SMS_SIGN = '天天smiles公众号'
SECRET_ID = 'AKIDznLddMp1wZ3KM8gy1oLdgT0HI3Yopa8T'
SECRET_KEY = '7zcz6yaw3vXszqRmrhHbeS0HH1VieJiq'
libs/sms/__init__.py
from .v2 import send_sms as send_sms_v2
from .v3 import send_sms as send_sms_v3
from .code import gen_code
libs/sms/code.py
import random
# 生成4,或5位的验证码
def gen_code(length=4):
code_str = ''
for i in range(length):
code_str += str(random.randrange(0, 9)) # python 是动态强类型,所以需要转换
return code_str
libs/sms/v2.py(此处代码到https://cloud.tencent.com/document/product/382/11672复制,略微修改)
from qcloudsms_py import SmsSingleSender
from qcloudsms_py.httpclient import HTTPError
from . import settings
from utils.logging import logger
def send_sms(phone, code, exp=2):
ssender = SmsSingleSender(settings.APP_ID, settings.APP_KEY)
params = [code, exp]
try:
result = ssender.send_with_param(86, phone, settings.TEMPLATE_ID, params, sign=settings.SMS_SIGN, extend="",
ext="")
if result['result'] == 0:
return True
else:
logger.error('发送短信失败,失败原因为:%s' % result['errmsg'])
return False
except Exception as e:
logger.error('发送短信失败,失败原因为:%s' % str(e))
return False
libs/sms/v3.py
from . import settings
def send_sms(phone, code, exp='2'):
# -*- coding: utf-8 -*-
from tencentcloud.common import credential
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
# 导入对应产品模块的client models。
from tencentcloud.sms.v20210111 import sms_client, models
# 导入可选配置类
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
try:
cred = credential.Credential(settings.SECRET_ID, settings.SECRET_KEY)
httpProfile = HttpProfile()
httpProfile.reqMethod = "POST" # post请求(默认为post请求)
httpProfile.reqTimeout = 30 # 请求超时时间,单位为秒(默认60秒)
httpProfile.endpoint = "sms.tencentcloudapi.com" # 指定接入地域域名(默认就近接入)
# 非必要步骤:
# 实例化一个客户端配置对象,可以指定超时时间等配置
clientProfile = ClientProfile()
clientProfile.signMethod = "TC3-HMAC-SHA256" # 指定签名算法
clientProfile.language = "en-US"
clientProfile.httpProfile = httpProfile
# 实例化要请求产品(以sms为例)的client对象
# 第二个参数是地域信息,可以直接填写字符串ap-guangzhou,支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8
client = sms_client.SmsClient(cred, "ap-guangzhou", clientProfile)
# 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数
# 你可以直接查询SDK源码确定SendSmsRequest有哪些属性可以设置
# 属性可能是基本类型,也可能引用了另一个数据结构
# 推荐使用IDE进行开发,可以方便的跳转查阅各个接口和数据结构的文档说明
req = models.SendSmsRequest()
# 基本类型的设置:
# SDK采用的是指针风格指定参数,即使对于基本类型你也需要用指针来对参数赋值。
# SDK提供对基本类型的指针引用封装函数
# 帮助链接:
# 短信控制台: https://console.cloud.tencent.com/smsv2
# sms helper: https://cloud.tencent.com/document/product/382/3773
# 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId,示例如1400006666
req.SmsSdkAppId = settings.APP_ID
# 短信签名内容: 使用 UTF-8 编码,必须填写已审核通过的签名,签名信息可登录 [短信控制台] 查看
req.SignName = settings.SMS_SIGN
# 短信码号扩展号: 默认未开通,如需开通请联系 [sms helper]
req.ExtendCode = ""
# 用户的 session 内容: 可以携带用户侧 ID 等上下文信息,server 会原样返回
req.SessionContext = "xxx"
# 国际/港澳台短信 senderid: 国内短信填空,默认未开通,如需开通请联系 [sms helper]
req.SenderId = ""
# 下发手机号码,采用 E.164 标准,+[国家或地区码][手机号]
# 示例如:+8613711112222, 其中前面有一个+号 ,86为国家码,13711112222为手机号,最多不要超过200个手机号
req.PhoneNumberSet = ["+86" + phone, ]
# 模板 ID: 必须填写已审核通过的模板 ID。模板ID可登录 [短信控制台] 查看
req.TemplateId = settings.TEMPLATE_ID
# 模板参数: 若无模板参数,则设置为空
req.TemplateParamSet = [code, exp]
# 通过client对象调用DescribeInstances方法发起请求。注意请求方法名与请求对象是对应的。
# 返回的resp是一个DescribeInstancesResponse类的实例,与请求对象对应。
resp = client.SendSms(req)
# 输出json格式的字符串回包
#print(resp.to_json_string(indent=2) #这里容易出错,需要转为字典
import json
res_dict = json.loads(resp.to_json_string(indent=2))
print(res_dict)
if res_dict['SendStatusSet'][0]['Code'] == 'Ok':
return True
else:
return False
except TencentCloudSDKException as err:
print(err)
return False