class VoicePromptSender:
appid = 0
appkey = 'default_key'
url = "/v5/tlsvoicesvr/sendvoiceprompt"
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
""" 语音验证码发送
Returns:
请求包体
{
"tel": {
"nationcode": "86", //国家码
"mobile": "13788888888" //手机号码
},
"prompttype": 2, //语音类型，目前固定为2
"promptfile": "语音内容文本", //通知内容，utf8编码，支持中文英文、数字及组合，需要和语音内容模版相匹配
"playtimes": 2, //播放次数，可选，最多3次，默认2次
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证，具体计算方式见下注
"time": 1457336869, //unix时间戳，请求发起时间，如果和系统时间相差超过10分钟则会返回失败
"ext": "" //用户的session内容，腾讯server回包中会原样返回，可选字段，不需要就填空。
}
应答包体
{
"result": 0, //0表示成功，非0表示失败
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容，腾讯server回包中会原样返回
"callid": "xxxx" //标识本次发送id，标识一次下发记录
}
参数说明:
nation_code: 国家码，如 86 为中国
phone_number: 不带国家码的手机号
msg: 信息内容，必须与申请的模板格式一致，否则将返回错误
ext: 服务端原样返回的参数，可填空串
"""
def send(self, nation_code, phone_number, playtimes, msg, ext):
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
tel = {"nationcode": nation_code, "mobile": phone_number}
data["tel"] = tel
data["prompttype"] = 2
data["promptfile"] = msg
data["playtimes"] = playtimes
data["sig"] = hashlib.sha256("appkey=" + self.appkey + "&random=" +
str(rnd) + "&time=" + str(cur_time) +
"&mobile=" + phone_number).hexdigest()
data["time"] = cur_time
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(
self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
class VoicePromptSender:
appid = 0
appkey = 'default_key'
url = "/v5/tlsvoicesvr/sendvoiceprompt"
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
""" 语音验证码发送
Returns:
请求包体
{
"tel": {
"nationcode": "86", //国家码
"mobile": "13788888888" //手机号码
},
"prompttype": 2, //语音类型，目前固定为2
"promptfile": "语音内容文本", //通知内容，utf8编码，支持中文英文、数字及组合，需要和语音内容模版相匹配
"playtimes": 2, //播放次数，可选，最多3次，默认2次
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证，具体计算方式见下注
"time": 1457336869, //unix时间戳，请求发起时间，如果和系统时间相差超过10分钟则会返回失败
"ext": "" //用户的session内容，腾讯server回包中会原样返回，可选字段，不需要就填空。
}
应答包体
{
"result": 0, //0表示成功，非0表示失败
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容，腾讯server回包中会原样返回
"callid": "xxxx" //标识本次发送id，标识一次下发记录
}
参数说明:
nation_code: 国家码，如 86 为中国
phone_number: 不带国家码的手机号
msg: 信息内容，必须与申请的模板格式一致，否则将返回错误
ext: 服务端原样返回的参数，可填空串
"""
def send(self,nation_code, phone_number,playtimes,msg, ext):
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
tel = {"nationcode": nation_code, "mobile": phone_number}
data["tel"] = tel
data["prompttype"] = 2
data["promptfile"] = msg
data["playtimes"] = playtimes
data["sig"] = hashlib.sha256("appkey=" + self.appkey + "&random=" + str(rnd)
+ "&time=" + str(cur_time) + "&mobile=" + phone_number).hexdigest()
data["time"] = cur_time
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
class SmsMultiSender:
""" 群发类定义"""
appid = 0
appkey = ""
url = "https://yun.tim.qq.com/v5/tlssmssvr/sendmultisms2"
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
def send(self, sms_type, nation_code, phone_numbers, msg, extend, ext):
""" 普通群发
【注意】海外短信没有群发功能
Args:
sms_type: 短信类型，0 为普通短信，1 为营销短信
nation_code: 国家码，如 86 为中国
phone_numbers: 不带国家码的手机号列表
msg: 信息内容，必须与申请的模板格式一致，否则将返回错误
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": [
{
"nationcode": "86",
"mobile": "13788888888"
},
{
"nationcode": "86",
"mobile": "13788888889"
}
],
"type": 0,
"msg": "你的验证码是1234",
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"detail": [
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888888",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
},
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888889",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
}
]
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
data["tel"] = self.util.phone_numbers_to_list(nation_code,
phone_numbers)
data["type"] = sms_type
data["msg"] = msg
data["sig"] = self.util.calculate_sig(self.appkey, rnd, cur_time,
phone_numbers)
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(
self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
def send_with_param(self, nation_code, phone_numbers, templ_id, params,
sign, extend, ext):
""" 指定模板群发
【注意】海外短信没有群发功能
Args:
nation_code: 国家码，如 86 为中国
phone_numbers: 不带国家码的手机号列表
templ_id: 模板 id
params: 模板参数列表，如模板 {1}...{2}...{3}，那么需要带三个参数
sign: 签名，如果填空串，系统会使用默认签名
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": {
"nationcode": "86",
"mobile": "13788888888"
},
"sign": "腾讯云",
"tpl_id": 19,
"params": [
"验证码",
"1234",
"4"
],
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"detail": [
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888888",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
},
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888889",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
}
]
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
data["tel"] = self.util.phone_numbers_to_list(nation_code,
phone_numbers)
data["sign"] = sign
data["sig"] = self.util.calculate_sig_for_templ_phone_numbers(
self.appkey, rnd, cur_time, phone_numbers)
data["tpl_id"] = templ_id
data["params"] = params
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(
self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
class SmsSingleSender:
""" 单发类定义"""
appid = 0
appkey = ""
url = "https://yun.tim.qq.com/v5/tlssmssvr/sendsms"
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
def send(self, sms_type, nation_code, phone_number, msg, extend, ext):
""" 普通群发接口
明确指定内容，如果有多个签名，请在内容中以【】的方式添加到信息内容中，否则系统将使用默认签名
Args:
sms_type: 短信类型，0 为普通短信，1 为营销短信
nation_code: 国家码，如 86 为中国
phone_number: 不带国家码的手机号
msg: 信息内容，必须与申请的模板格式一致，否则将返回错误
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": {
"nationcode": "86",
"mobile": "13788888888"
},
"type": 0,
"msg": "你的验证码是1234",
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"sid": "xxxxxxx",
"fee": 1
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
tel = {"nationcode": nation_code, "mobile": phone_number}
data["tel"] = tel
data["type"] = sms_type
data["msg"] = msg
data["sig"] = hashlib.sha256("appkey=" + self.appkey + "&random=" +
str(rnd) + "&time=" + str(cur_time) +
"&mobile=" + phone_number).hexdigest()
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(
self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
def send_with_param(self, nation_code, phone_number, templ_id, params,
sign, extend, ext):
""" 指定模板单发
Args:
nation_code: 国家码，如 86 为中国
phone_number: 不带国家码的手机号
templ_id: 模板 id
params: 模板参数列表，如模板 {1}...{2}...{3}，那么需要带三个参数
sign: 签名，如果填空串，系统会使用默认签名
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": {
"nationcode": "86",
"mobile": "13788888888"
},
"sign": "腾讯云",
"tpl_id": 19,
"params": [
"验证码",
"1234",
"4"
],
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"sid": "xxxxxxx",
"fee": 1
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
tel = {"nationcode": nation_code, "mobile": phone_number}
data["tel"] = tel
data["tpl_id"] = templ_id
data["sign"] = sign
data["sig"] = self.util.calculate_sig_for_templ(
self.appkey, rnd, cur_time, phone_number)
data["params"] = params
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(
self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
class SmsMultiSender:
""" 群发类定义"""
appid = 0
appkey = ""
url = "https://yun.tim.qq.com/v5/tlssmssvr/sendmultisms2"
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
def send(self, sms_type, nation_code, phone_numbers, msg, extend, ext):
""" 普通群发
【注意】海外短信没有群发功能
Args:
sms_type: 短信类型，0 为普通短信，1 为营销短信
nation_code: 国家码，如 86 为中国
phone_numbers: 不带国家码的手机号列表
msg: 信息内容，必须与申请的模板格式一致，否则将返回错误
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": [
{
"nationcode": "86",
"mobile": "13788888888"
},
{
"nationcode": "86",
"mobile": "13788888889"
}
],
"type": 0,
"msg": "你的验证码是1234",
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"detail": [
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888888",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
},
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888889",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
}
]
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
data["tel"] = self.util.phone_numbers_to_list(nation_code, phone_numbers)
data["type"] = sms_type
data["msg"] = msg
data["sig"] = self.util.calculate_sig(self.appkey, rnd, cur_time, phone_numbers)
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
def send_with_param(self, nation_code, phone_numbers, templ_id, params, sign, extend, ext):
""" 指定模板群发
【注意】海外短信没有群发功能
Args:
nation_code: 国家码，如 86 为中国
phone_numbers: 不带国家码的手机号列表
templ_id: 模板 id
params: 模板参数列表，如模板 {1}...{2}...{3}，那么需要带三个参数
sign: 签名，如果填空串，系统会使用默认签名
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": {
"nationcode": "86",
"mobile": "13788888888"
},
"sign": "腾讯云",
"tpl_id": 19,
"params": [
"验证码",
"1234",
"4"
],
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"detail": [
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888888",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
},
{
"result": 0,
"errmsg": "OK",
"mobile": "13788888889",
"nationcode": "86",
"sid": "xxxxxxx",
"fee": 1
}
]
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
data["tel"] = self.util.phone_numbers_to_list(nation_code, phone_numbers)
data["sign"] = sign
data["sig"] = self.util.calculate_sig_for_templ_phone_numbers(self.appkey, rnd, cur_time, phone_numbers)
data["tpl_id"] = templ_id
data["params"] = params
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
class SmsSingleSender:
""" 单发类定义"""
appid = 0
appkey = ""
url = "https://yun.tim.qq.com/v5/tlssmssvr/sendsms"
def __init__(self, appid, appkey):
self.appid = appid
self.appkey = appkey
self.util = SmsSenderUtil()
def send(self, sms_type, nation_code, phone_number, msg, extend, ext):
""" 普通群发接口
明确指定内容，如果有多个签名，请在内容中以【】的方式添加到信息内容中，否则系统将使用默认签名
Args:
sms_type: 短信类型，0 为普通短信，1 为营销短信
nation_code: 国家码，如 86 为中国
phone_number: 不带国家码的手机号
msg: 信息内容，必须与申请的模板格式一致，否则将返回错误
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": {
"nationcode": "86",
"mobile": "13788888888"
},
"type": 0,
"msg": "你的验证码是1234",
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"sid": "xxxxxxx",
"fee": 1
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
tel = {"nationcode": nation_code, "mobile": phone_number}
data["tel"] = tel
data["type"] = sms_type
data["msg"] = msg
data["sig"] = hashlib.sha256("appkey=" + self.appkey + "&random=" + str(rnd)
+ "&time=" + str(cur_time) + "&mobile=" + phone_number).hexdigest()
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)
def send_with_param(self, nation_code, phone_number, templ_id, params, sign, extend, ext):
""" 指定模板单发
Args:
nation_code: 国家码，如 86 为中国
phone_number: 不带国家码的手机号
templ_id: 模板 id
params: 模板参数列表，如模板 {1}...{2}...{3}，那么需要带三个参数
sign: 签名，如果填空串，系统会使用默认签名
extend: 扩展码，可填空串
ext: 服务端原样返回的参数，可填空串
Returns:
json string { "result": xxxx, "errmsg": "xxxxx" ... }，被省略的内容参见协议文档
请求包体
{
"tel": {
"nationcode": "86",
"mobile": "13788888888"
},
"sign": "腾讯云",
"tpl_id": 19,
"params": [
"验证码",
"1234",
"4"
],
"sig": "fdba654e05bc0d15796713a1a1a2318c",
"time": 1479888540,
"extend": "",
"ext": ""
}
应答包体
{
"result": 0,
"errmsg": "OK",
"ext": "",
"sid": "xxxxxxx",
"fee": 1
}
"""
rnd = self.util.get_random()
cur_time = self.util.get_cur_time()
data = {}
tel = {"nationcode": nation_code, "mobile": phone_number}
data["tel"] = tel
data["tpl_id"] = templ_id
data["sign"] = sign
data["sig"] = self.util.calculate_sig_for_templ(self.appkey, rnd, cur_time, phone_number)
data["params"] = params
data["time"] = cur_time
data["extend"] = extend
data["ext"] = ext
whole_url = self.url + "?sdkappid=" + str(self.appid) + "&random=" + str(rnd)
return self.util.send_post_request("yun.tim.qq.com", whole_url, data)