SDK 3.0是云 API 3.0平台的配套工具,您可以通过 SDK 使用所有 短信 API。新版 SDK 实现了统一化,具有各个语言版本的 SDK 使用方法相同,接口调用方式相同,错误码相同以及返回包格式相同等优点。
注意
发送短信相关接口
一次群发请求最多支持200个号码。
前提条件
已开通短信服务,具体操作请参见 国内短信快速入门。
如需发送国内短信,需要先 购买国内短信套餐包。
已准备依赖环境:Python 2.7 - 3.6 版本。
已在访问管理控制台 > API密钥管理 页面获取 SecretID 和 SecretKey。
SecretID 用于标识 API 调用者的身份。
SecretKey 用于加密签名字符串和服务器端验证签名字符串的密钥,SecretKey 需妥善保管,避免泄露。
短信的调用地址为
sms.tencentcloudapi.com
。相关资料
各个接口及其参数的详细介绍请参见 API 文档。
下载 SDK 源码请访问 Python SDK 源码。
安装 SDK
通过 pip 安装(推荐)
1. 下载并安装 pip。
2. 执行以下命令安装 SDK。
pip install tencentcloud-sdk-python
通过源码包安装
1. 前往 Github 代码托管地址下载最新代码。
2. 解压后依次执行以下命令安装 SDK。
$ cd tencentcloud-sdk-python$ python setup.py install
示例代码
说明
每个接口都有一个对应的 Request 结构和一个 Response 结构。本文仅列举几个常用功能的示例代码,如下所示。
申请短信模板
# -*- coding: utf-8 -*-from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException# 导入 SMS 模块的 client modelsfrom tencentcloud.sms.v20190711 import sms_client, models# 导入可选配置类from tencentcloud.common.profile.client_profile import ClientProfilefrom tencentcloud.common.profile.http_profile import HttpProfiletry:# 必要步骤:# 实例化一个认证对象,入参需要传入腾讯云账户密钥对 secretId 和 secretKey# 本示例采用从环境变量读取的方式,需要预先在环境变量中设置这两个值# 您也可以直接在代码中写入密钥对,但需谨防泄露,不要将代码复制、上传或者分享给他人# CAM 密钥查询:https://console.cloud.tencent.com/cam/capicred = credential.Credential("secretId", "secretKey")# cred = credential.Credential(# os.environ.get(""),# os.environ.get("")# )# 实例化一个 http 选项,可选,无特殊需求时可以跳过httpProfile = HttpProfile()# 如果需要指定proxy访问接口,可以按照如下方式初始化hp# httpProfile = HttpProfile(proxy="http://用户名:密码@代理IP:代理端口")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,或者引用预设的常量client = sms_client.SmsClient(cred, "ap-guangzhou", clientProfile)# 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数# 您可以直接查询 SDK 源码确定 SendSmsRequest 有哪些属性可以设置# 属性可能是基本类型,也可能引用了另一个数据结构# 推荐使用 IDE 进行开发,可以方便的跳转查阅各个接口和数据结构的文档说明req = models.AddSmsTemplateRequest()# 基本类型的设置:# SDK 采用的是指针风格指定参数,即使对于基本类型也需要用指针来对参数赋值# SDK 提供对基本类型的指针引用封装函数# 帮助链接:# 短信控制台:https://console.cloud.tencent.com/smsv2# sms helper:https://cloud.tencent.com/document/product/382/3773# 模板名称req.TemplateName = "腾讯云"# 模板内容req.TemplateContent = "{1}为您的登录验证码,请于{2}分钟内填写,如非本人操作,请忽略本短信。"# 短信类型:0表示普通短信, 1表示营销短信req.SmsType = 0;# 是否国际/港澳台短信:# 0:表示国内短信# 1:表示国际/港澳台短信req.International = 0# 模板备注:例如申请原因,使用场景等req.Remark = "xxx"# 通过 client 对象调用 AddSmsTemplate 方法发起请求。注意请求方法名与请求对象是对应的resp = client.AddSmsTemplate(req)# 输出 JSON 格式的字符串回包print(resp.to_json_string(indent=2))except TencentCloudSDKException as err:print(err)
发送短信
# -*- coding: utf-8 -*-from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException# 导入 SMS 模块的client modelsfrom tencentcloud.sms.v20190711 import sms_client, models# 导入可选配置类from tencentcloud.common.profile.client_profile import ClientProfilefrom tencentcloud.common.profile.http_profile import HttpProfiletry:# 必要步骤:# 实例化一个认证对象,入参需要传入腾讯云账户密钥对 secretId 和 secretKey# 本示例采用从环境变量读取的方式,需要预先在环境变量中设置这两个值# 您也可以直接在代码中写入密钥对,但需谨防泄露,不要将代码复制、上传或者分享给他人# CAM 密钥查询:https://console.cloud.tencent.com/cam/capicred = credential.Credential("secretId", "secretKey")# cred = credential.Credential(# os.environ.get(""),# os.environ.get("")# )# 实例化一个 http 选项,可选,无特殊需求时可以跳过httpProfile = HttpProfile()# 如果需要指定proxy访问接口,可以按照如下方式初始化hp# httpProfile = HttpProfile(proxy="http://用户名:密码@代理IP:代理端口")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,或者引用预设的常量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,例如1400006666req.SmsSdkAppid = "1400787878"# 短信签名内容: 使用 UTF-8 编码,必须填写已审核通过的签名,可登录 [短信控制台] 查看签名信息req.Sign = "xxx"# 短信码号扩展号: 默认未开通,如需开通请联系 [sms helper]req.ExtendCode = ""# 用户的 session 内容: 可以携带用户侧 ID 等上下文信息,server 会原样返回req.SessionContext = "xxx"# 国际/港澳台短信 senderid: 国内短信填空,默认未开通,如需开通请联系 [sms helper]req.SenderId = ""# 下发手机号码,采用 e.164 标准,+[国家或地区码][手机号]# 例如+8613711112222, 其中前面有一个+号 ,86为国家码,13711112222为手机号,最多不要超过200个手机号req.PhoneNumberSet = ["+8613711112222", "+8613711333222", "+8613711144422"]# 模板 ID: 必须填写已审核通过的模板 ID,可登录 [短信控制台] 查看模板 IDreq.TemplateID = "449739"# 模板参数: 若无模板参数,则设置为空req.TemplateParamSet = ["666"]# 通过 client 对象调用 SendSms 方法发起请求。注意请求方法名与请求对象是对应的resp = client.SendSms(req)# 输出 JSON 格式的字符串回包print(resp.to_json_string(indent=2))except TencentCloudSDKException as err:print(err)
拉取回执状态
# -*- coding: utf-8 -*-from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException# 导入 SMS 模块的 client modelsfrom tencentcloud.sms.v20190711 import sms_client, models# 导入可选配置类from tencentcloud.common.profile.client_profile import ClientProfilefrom tencentcloud.common.profile.http_profile import HttpProfiletry:# 必要步骤:# 实例化一个认证对象,入参需要传入腾讯云账户密钥对 secretId 和 secretKey# 本示例采用从环境变量读取的方式,需要预先在环境变量中设置这两个值# 您也可以直接在代码中写入密钥对,但需谨防泄露,不要将代码复制、上传或者分享给他人# CAM 密钥查询:https://console.cloud.tencent.com/cam/capicred = credential.Credential("secretId", "secretKey")# cred = credential.Credential(# os.environ.get(""),# os.environ.get("")# )# 实例化一个 http 选项,可选,无特殊需求时可以跳过httpProfile = HttpProfile()# 如果需要指定proxy访问接口,可以按照如下方式初始化hp# httpProfile = HttpProfile(proxy="http://用户名:密码@代理IP:代理端口")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,或者引用预设的常量client = sms_client.SmsClient(cred, "ap-guangzhou", clientProfile)# 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数# 您可以直接查询 SDK 源码确定 SendSmsRequest 有哪些属性可以设置# 属性可能是基本类型,也可能引用了另一个数据结构# 推荐使用 IDE 进行开发,可以方便的跳转查阅各个接口和数据结构的文档说明req = models.PullSmsSendStatusRequest()# 基本类型的设置:# SDK 采用的是指针风格指定参数,即使对于基本类型也需要用指针来对参数赋值# SDK 提供对基本类型的指针引用封装函数# 帮助链接:# 短信控制台:https://console.cloud.tencent.com/smsv2# sms helper:https://cloud.tencent.com/document/product/382/3773# 短信应用 ID: 在 [短信控制台] 添加应用后生成的实际 SDKAppID,例如1400006666req.SmsSdkAppid = "1400787878"# 拉取最大条数,最多100条req.Limit = 10# 通过 client 对象调用 PullSmsSendStatus 方法发起请求。注意请求方法名与请求对象是对应的resp = client.PullSmsSendStatus(req)# 输出 JSON 格式的字符串回包print(resp.to_json_string(indent=2))except TencentCloudSDKException as err:print(err)
统计短信发送数据
# -*- coding: utf-8 -*-from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException# 导入 SMS 模块的client modelsfrom tencentcloud.sms.v20190711 import sms_client, models# 导入可选配置类from tencentcloud.common.profile.client_profile import ClientProfilefrom tencentcloud.common.profile.http_profile import HttpProfiletry:# 必要步骤:# 实例化一个认证对象,入参需要传入腾讯云账户密钥对 secretId 和 secretKey# 本示例采用从环境变量读取的方式,需要预先在环境变量中设置这两个值# 您也可以直接在代码中写入密钥对,但需谨防泄露,不要将代码复制、上传或者分享给他人# CAM 密钥查询:https://console.cloud.tencent.com/cam/capicred = credential.Credential("secretId", "secretKey")# cred = credential.Credential(# os.environ.get(""),# os.environ.get("")# )# 实例化一个 http 选项,可选,无特殊需求时可以跳过httpProfile = HttpProfile()# 如果需要指定proxy访问接口,可以按照如下方式初始化hp# httpProfile = HttpProfile(proxy="http://用户名:密码@代理IP:代理端口")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,或者引用预设的常量client = sms_client.SmsClient(cred, "ap-guangzhou", clientProfile)# 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数# 您可以直接查询 SDK 源码确定 SendSmsRequest 有哪些属性可以设置# 属性可能是基本类型,也可能引用了另一个数据结构# 推荐使用 IDE 进行开发,可以方便的跳转查阅各个接口和数据结构的文档说明req = models.SendStatusStatisticsRequest()# 基本类型的设置:# SDK 采用的是指针风格指定参数,即使对于基本类型也需要用指针来对参数赋值# SDK 提供对基本类型的指针引用封装函数# 帮助链接:# 短信控制台:https://console.cloud.tencent.com/smsv2# sms helper:https://cloud.tencent.com/document/product/382/3773# 短信应用 ID: 在 [短信控制台] 添加应用后生成的实际 SDKAppID,例如1400006666req.SmsSdkAppid = "1400787878"# 拉取最大条数,最多100条req.Limit = 10# 偏移量 注:目前固定设置为0req.Offset = 0# 开始时间,yyyymmddhh 需要拉取的起始时间,精确到小时req.StartDateTime = 2019122400# 结束时间,yyyymmddhh 需要拉取的截止时间,精确到小时# 注:EndDataTime 必须大于 StartDateTimereq.EndDataTime = 2019122523# 通过 client 对象调用 SendStatusStatistics 方法发起请求。注意请求方法名与请求对象是对应的resp = client.SendStatusStatistics(req)# 输出 JSON 格式的字符串回包print(resp.to_json_string(indent=2))except TencentCloudSDKException as err:print(err)
常见问题
证书问题
在 Mac 操作系统安装 Python 3.6 或以上版本时,可能会遇到证书错误:
Error: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self signed certificate in certificate chain (_ssl.c:1056).
这是因为在 Mac 操作系统下,Python 不再使用系统默认的证书,且本身也不提供证书。在进行 HTTPS 请求时,需要使用
certifi
库提供的证书,但 SDK 不支持指定,所以只能使用sudo "/Applications/Python 3.6/Install Certificates.command"
命令安装证书才能解决此问题。虽然 Python 2 版本不应该有上述问题,但在个别用户环境上可能也会存在类似的情况,同样可以通过
sudo /Applications/Python 2.7/Install Certificates.command
解决。代理设置
如果是有代理的环境下,可通过以下两种方式设置代理:
在初始化 HttpProfile 时指定 proxy,参考 example。
需要设置系统环境变量
https_proxy
。否则可能无法正常调用,抛出连接超时的异常。