1-Python - 短信服务

目录

about

在项目中集成短信功能，如短信验证登录、发送短信通知，现在非常普遍，所以本篇记录下如何在项目中集成短信功能。
由于监管严格，有的短信服务商开通短信服务的资质也越来越严格，导致我们在开发阶段，不得不尝试其它更多厂家的，目前(2023/5/16)据我了解，不确认以后会不会放开个人资质认证:

  • 腾讯云，现在开通短信服务要么你要有公司资质、要么是已经上线并且备案的小程序这些，所以开通门槛有点高了。
  • 容联云，之前还支持个人认证，目前(2023/5/24)只支持公司认证了，不支持个人认证，但它提供了一个测试号码，也就是我们开发阶段使用这个测试号码也是可以的。
  • 互亿无线的106短信，这个今天我测了下，现在还能支持个人认证，总之开通和认证都简单、代码也不难，配置也相对简单，如果是个人项目开发阶段，用这个也行。

容联云短信

这里演示下如何开通容联云的短信测试账号，保证我们开发阶段的短信服务正常使用。

配置过程

1. 注册，没啥好说的了，注册地址：https://console.yuntongxun.com/user/reg/init

2. 注册成功，在控制台首页(https://console.yuntongxun.com/member/main)，就能获取到以下信息

3. 添加测试号码，这就是未通过认证，我们只能在开发中，在这里添加最多3个测试号码来进行开发中使用

4. 短信模板
短信模板这块，由于是测试使用，我们只能使用固定的短信模板了，我写这部分博客时，发出的短信长这样：

【云通讯】您使用的是云通讯短信模板，您的验证码是4653，请于2分钟内正确输入（变量仅支持1-4位数字）

要想更换短信模板，就要充钱了.....所以，我们还是凑活用吧，上线了再改一样。
所以，这里我们能知道的就是一个模板ID为1，这个后面发短信要用到，记好了。
5. 发送短信示例
各语言参考手册：

来个Python的示例，先下载对应的模块：

pip install ronglian_sms_sdk

然后来上demo示例，当然这个示例完全可以集成到你的项目中：

import random
import json
from ronglian_sms_sdk import SmsSDK
def send_sms(mobile, datas, tid=1):
    """
    发送短信
    @params tid: 模板ID，默认测试使用1
    @params mobile: 接收短信的手机号，多个手机号使用都逗号隔开
            单个号码： mobile="13312345678"
            多个号码： mobile="13312345678,13312345679,...."
    @params datas: 短信模板的参数列表
            例如短信模板为： 【云通讯】您的验证码是{1}，请于{2}分钟内正确输入。
            则datas=("3456",2,)
            最终发送的短信为：【云通讯】您的验证码是{3456}，请于{5}分钟内正确输入。
    """
    RONGLIANYUN_CONFIG = {
        # 下面这三个值都可以从控制台首页的开发者主账号中进行获取
        "accId": '2c94811c87fb71111881e50a8ed0b39',  # 对应：ACCOUNT SID
        "accToken": '23d2e5f9f7111e888eb2a6848dae42',  # 对应：AUTH TOKEN
        "appId": '2c94811c87fb11101881e50aa210b40',  # 对应：AppID(默认)
        "reg_tid": 1,       # 注册短信验证码的模板ID，测试阶段固定为1
        "sms_expire": 120,  # 短信有效期，单位：秒(s)，这是真正的超时时间，注意和datas=("3456",2,)中第二个参数进行换算，保持一致
        "sms_interval": 60,  # 短信发送的冷却时间，单位：秒(s)
    }

    sdk = SmsSDK(RONGLIANYUN_CONFIG.get("accId"), RONGLIANYUN_CONFIG.get("accToken"), RONGLIANYUN_CONFIG.get("appId"))
    resp = sdk.sendMessage(str(tid), mobile, datas)
    response = json.loads(resp)
    print(response, type(response))
    """
    Sign plaintext:  2c94811c87fb7ec601881e50a8ed0b3923d2e5f9f7694d9e888eb2a6848dae4220230524140059
    Authorization plaintext: 2c94811c87fb7ec601881e50a8ed0b39:20230524140059
    Request url:  https://app.cloopen.com:8883/2013-12-26/Accounts/2c94811c87fb7ec601881e50a8ed0b39/SMS/TemplateSMS?sig=6FB880CDC9671A41674C17DE348D300B
    Request headers:  {'Content-Type': 'application/json;charset=utf-8', 'Accept': 'application/json', 'Accept-Charset': 'UTF-8', 'Authorization': b'MmM5NDgxMWM4N2ZiN2VjNjAxODgxZTUwYThlZDBiMzk6MjAyMzA1MjQxNDAwNTk='}
    Request body:  {"to": "18211101742", "appId": "2c94811c87fb7ec601881e50aa210b40", "templateId": "1", "datas": [4653, 2]}
    Response body:  {"statusCode":"000000","templateSMS":{"smsMessageSid":"8bcc77c455084a6b8d52983e95f10977","dateCreated":"20230524140100"}}
    {'statusCode': '000000', 'templateSMS': {'smsMessageSid': '8bcc77c455084a6b8d52983e95f10977', 'dateCreated': '20230524140100'}} <class 'dict'>
    """
    # statusCode是'000000'表示发送成功
    # 手机上接收到的短信长这样
    """
    【云通讯】您使用的是云通讯短信模板，您的验证码是4653，请于2分钟内正确输入（变量仅支持1-4位数字）
    """
    return response.get("statusCode") == "000000"

def get_code(num=4):
    """
    生成指定位数的验证码，如果不传值，就默认生成4位的验证码
    :param num: 要生成几位的验证码
    :return: 生成的验证码
    """
    return random.randint(
        int('1{}'.format('0' * (num - 1))),
        int('9{}'.format('9' * (num - 1)))
    )

if __name__ == '__main__':

    send_sms(
        mobile='18211101111',   # 这个手机号必须在你在容联云中填写的那个3个测试手机号中
        datas=(get_code(4), 2),  # 元组的第一个参数是4位的验证码,注意免费测试的只支持发送4位的验证码，不支持6位的，第二个参数是短信模板中替换为：请于{2}分钟内正确输入
        tid=1                   # 这个模板id目前测试阶段固定为1
    )

常见报错

{'statusCode': '161125', 'statusMsg': '请输入1到4位的数字'}

这个报错很明显是规定只能发送4位的验证码，你却发送了6的验证码，所以报错了，解决办法就是生成4位验证码即可。

互亿无线106短信

PS：注册后，互亿无线的客服会给你打电话问一下使用用途，说个人项目开发中使用即可，好用的话，会在公司中推荐正式使用的。
然后跟着我下面的流程走就行了，非常简单。

注册及认证

1. 实名注册：https://user.ihuyi.com/new/register.html?e=400

2. 注册成功后，会自动跳转到控制台，没自动跳转就手动点击网址：https://user.ihuyi.com/new/console

3. 点击认证，这里进行个人认证，然后按照下图提示在手机上进行微信认证。

4. 手机上进行微信认证，按照微信中的引导即可。

5. 浏览器中回到控制台的账号信息页面，发现认证通过了。https://user.ihuyi.com/new/console/account/infomation?jumpto=certify

现在认证完事了。

发送短信验证码基础版

当你注册认证通过之后，会得到10条免费短信，也会有个默认的短信模板(充值之后可以创建自定义模板)。

我们可以尝试使用默认的模板和免费短信来写个demo示例，示例中还需要两个参数需要我们提前准备好。

#定义请求的数据
values = {
    'account': 'C05062023',   			      # 这个是对应的APIID
    'password': 'aff16e275e46618efd14f21b00ad12391',  # 这个是对应的APIKEY
    'mobile': mobile,  # 你要发给谁
    'content': '您的验证码是：7835。请不要把验证码泄露给其他人。',  # 没有购买套餐的，这个模板只能使用默认的，即你收到的短信长这样：【互亿无线】您的验证码是：7835。请不要把验证码泄露给其他人。
    'format': 'json',
}

上面请求参数中，我们需要准备的是APIID和APIKEY，这俩在如下图所示的位置可以找到：https://user.ihuyi.com/new/sms/overview

下面的示例是基于Python3的示例：

#python3
#接口类型：互亿无线触发短信接口，支持发送验证码短信、订单通知短信等。
#账户注册：请通过该地址开通账户https://user.ihuyi.com/new/register.html
#注意事项：
#（1）调试期间，请用默认的模板进行测试，默认模板详见接口文档；
#（2）请使用 用户名 及 APIkey来调用接口，APIkey在会员中心可以获取；
#（3）该代码仅供接入互亿无线短信接口参考使用，客户可根据实际需要自行编写；

import random
import urllib.parse
import urllib.request

def get_code(num=4):
    """
    生成指定位数的验证码，如果不传值，就默认生成4位的验证码
    :param num: 要生成几位的验证码
    :return: 生成的验证码
    """
    return random.randint(
        int('1{}'.format('0' * (num - 1))),
        int('9{}'.format('9' * (num - 1)))
    )
    
    
def send_sms(mobile, code_num=4):
    """
    发送短信验证码
    :param mobile: 你要发给谁
    :param code_num: 发送几位的验证码
    :return:
    """
    # 接口地址，咱们不需要更改
    url = 'http://106.ihuyi.com/webservice/sms.php?method=Submit'

    # 定义请求的数据
    values = {
        'account': 'APIID',    # 这个是对应的APIID
        'password': 'APIKEY',  # 这个是对应的APIKEY
        'mobile': mobile,      # 发给谁
        'content': '您的验证码是：{}。请不要把验证码泄露给其他人。'.format(get_code()),  # 没有购买套餐的，这个模板只能使用默认的，即你收到的短信长这样：【互亿无线】您的验证码是：7835。请不要把验证码泄露给其他人。
        'format': 'json',  # 不要动
    }

    # 将数据进行编码，下面代码不要动
    data = urllib.parse.urlencode(values).encode(encoding='UTF8')

    # 发起请求，下面代码不要动
    req = urllib.request.Request(url, data)
    response = urllib.request.urlopen(req)
    res = response.read()

    # 打印结果，然后你的手机应该就能接到短信了
    print(res.decode("utf8"))  # {"code":2,"msg":"提交成功","smsid":"16842079209571524017"}


if __name__ == '__main__':
    send_sms('接收短信的手机号')

腾讯云短信

python3.9
腾讯云短信服务官网：https://cloud.tencent.com/product/sms
腾讯云短信文档: https://cloud.tencent.com/document/product/382

具体的注册流程参考：https://pythonav.com/wiki/detail/10/81/

SDK方式发送短信

python3.9
短信模板:https://console.cloud.tencent.com/smsv2/csms-template
签名信息:https://console.cloud.tencent.com/smsv2/csms-sign
应用 ID:https://console.cloud.tencent.com/smsv2/app-manage
API密钥:https://console.cloud.tencent.com/cam/capi

前提(截止到2023/2/6)：

下载相应的SDK
通过pip下载SDK：

# 国内如果能访问GitHub的话可以通过这个命令下载，否则用下面的Gitee的也行
pip install --upgrade tencentcloud-sdk-python

# Gitee
pip install --upgrade tencentcloud-sdk-python

发送短信代码示例

请无脑的参考下面的流程就行了，让你去哪找就去哪找，让你改啥你就改啥，不让你改啥，别瞎动。

import random
import string
from tencentcloud.common import credential
from tencentcloud.sms.v20210111 import sms_client, models

# 注意，下面写法是固定的，你只需要按照上面给的链接中，获取对应的值，来修改即可

# 下面这俩值从这个页面中获取：https://console.cloud.tencent.com/cam/capi
SecretId = "AKIDQdZFemCGdlcCo9sQ9sKkwriIq776rUu423"
SecretKey = "FEvLZWBZgX7JFzRcW8VbgU7UZOvCuc3123"


cred = credential.Credential(
    secret_id=SecretId,    # 注意必须以关键字的形式传参
    secret_key=SecretKey   # 注意必须以关键字的形式传参
)  # secretId secretKey
client = sms_client.SmsClient(cred, "ap-guangzhou")  # 固定写法无需变动

req = models.SendSmsRequest()

# 应用id，注意这个是你创建的应用id，是这个链接：https://console.cloud.tencent.com/smsv2/app-manage 中的应用ID
# 强调，不是密钥页面的APPID，既不是这个页面的ID：https://console.cloud.tencent.com/cam/capi
req.SmsSdkAppId = "1400793123"  

# 模板签名：https://console.cloud.tencent.com/smsv2/csms-sign 也就是签名管理菜单中，找到你的签名内容
req.SignName = "张开与老虎"   # 模板签名

# 模板id从这个地址找：https://console.cloud.tencent.com/smsv2/csms-template， 也就是正文模板管理菜单
req.TemplateId = "5750123"   # 模板id(可以有多套模板进行更换，这样发送的短信内容就可以改变了)

# 下面就是结合模板填写具体要发送的验证码和手机号了
code = ''.join(random.sample(string.digits, 6))  # 随机生成的6位验证码
print(code)  # 671093

# 如果短信模板中只有一个值需要填充，那么列表中就放一个值就好了，注意，数字的话，必须是转成字符串类型。
req.TemplateParamSet = [code]  # 发送的6位验证码
# 如果你要发送的短信模板是这样的(您正在申请手机注册，验证码为：{1}，[2}分钟内有效！)，有多个值需要填充，就依次填写到列表中就好了，注意，数字的话，必须是转成字符串类型。
# req.TemplateParamSet = [code, '5']  # 发送的6位验证码

req.PhoneNumberSet = ["+8618211111111"]   # 目标手机号

resp = client.SendSms(req)  # 发送
print(resp)
"""
{
	"SendStatusSet": [
		{
			"SerialNo": "2433:326237685316756579077330174", 
			"PhoneNumber": "+8618211101111", 
			"Fee": 1, "SessionContext": "", 
			"Code": "Ok", "Message": "send success", "IsoCode": "CN"
			}
	], 
	"RequestId": "25147cb8-9abd-4100-bdbb-bb61cd3c2828"
}

# 你的手机号，应该接收到了短信：
【张开与老虎】验证码为：671093，您正在登录，若非本人操作，请勿泄露。
"""

更详细的示例参考官网：https://cloud.tencent.com/document/product/382/43196
错误码：https://cloud.tencent.com/document/product/382/38780

api形式实现短信发送

python3.9

常见报错

tencentcloud.common.exception.tencent_cloud_sdk_exception.TencentCloudSDKException: [TencentCloudSDKException] code:ClientNetworkError message:HTTPSConnectionPool(host='sms.tencentcloudapi.com', port=443): Max retries exceeded with url: / (Caused by ProxyError('Cannot connect to proxy.', timeout('_ssl.c:1114: The handshake operation timed out'))) requestId:None

如果你发短信的代码运行后，等了一段时间，然后报了超时的错误，而你又能正常的上网，那么优先检查你的电脑是否开着代理，有代理，短信服务就不可用。

tencentcloud.common.exception.tencent_cloud_sdk_exception.TencentCloudSDKException: [TencentCloudSDKException] code:ClientNetworkError message:HTTPSConnectionPool(host='sms.tencentcloudapi.com', port=443): Max retries exceeded with url: / (Caused by ProxyError('Cannot connect to proxy.', timeout('_ssl.c:1114: The handshake operation timed out'))) requestId:None

关闭代理再重发，就应该没问题了。

("SendstatusSet": [{"Seriao": "n, "phonenumben": "+8618211101111", "Fee": 0, "SessionContext": "n, "Code": "FailedOperation.InsufficientBalanceInSmsPackage", "Message": "insufficient balance in SMS package", "IsoCode": mny], "RequestId".85e31f2c-9507-49c3-a288-7ed741afbf16"}

这个错误根据官网的错误码，说是套餐包余量不足，需要充值了。

tencentcloud.common.exception.tencent_cloud_sdk_exception.TencentCloudSDKException: [TencentCloudSDKException] code:UnauthorizedOperation.SmsSdkAppIdVerifyFail message:request SmsSdk AppId verify fail requestId:6e63e34e-fa46-40ee-9281-320446e80c1a

这个报错没啥好说的，就是req.SmsSdkAppId的值获取错了，应该获取的是应用ID。
当然也要检查其他的参数是否填写正确。

腾讯短信发送成功，但手机接收不到短信

按照上面腾讯云短信的示例，发送短信成功了，打印结果也是：

{"SendStatusSet": [{"SerialNo": "2640:63003780816991009901530174", "PhoneNumber": "+8618211101742", "Fee": 1, "SessionContext": "", "Code": "Ok", "Message": "send success", "IsoCode": "CN"}], "RequestId": "959d08ca-9af8-4974-ab82-307a4dcee0a0"}

看发送结果肯定是没问题的，但是手机就是收不到消息，去腾讯云官档查统计分析记录，发现，被运营商拦截了：

解决办法就是腾讯云的人工服务吧。

posted @ 2022-09-09 14:07  听雨危楼  阅读(1176)  评论(0)  编辑  收藏  举报