帮你快速理解、总结文档立即下载

发送语音验证码

最近更新时间:2024-11-19 14:20:51
我的收藏

接口描述

功能描述

给中国大陆地区用户发语音验证码(仅支持数字)。

URL 示例

POST https://cloud.tim.qq.com/v5/tlsvoicesvr/sendcvoice?sdkappid=xxxxx&random=xxxx
其中,sdkappid请填写您在 语音消息控制台 添加应用后生成的实际 SDK AppID,random请填写成随机数字。

请求参数

{
"ext": "",
"msg": "1234",
"playtimes": 2,
"sig": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4",
"tel": {
"mobile": "13788888888",
"nationcode": "86"
},
"time": 1457336869
}
参数
必选
类型
描述
ext
否
string
用户的 session 内容,腾讯 server 回包中会原样返回。
msg
是
string
验证码,仅支持填写数字,实际播报语音时,会自动在数字前补充语音文本"您的验证码是"。
playtimes
否
number
播放次数,最多3次,默认2次。
sig
是
string
App 凭证,具体计算方式请参见下方说明。
tel
是
object
电话号码,详细参数说明请参见下方表格。
time
是
number
请求发起时间,UNIX 时间戳,如果和系统时间相差超过10分钟则会返回失败。
参数tel:
参数
必选
类型
描述
mobile
是
string
手机号码
nationcode
是
string
国家(或地区)码
说明:
sig字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成,其伪代码如下:
string strMobile = "13788888888"; //tel 的 mobile 字段的内容
string strAppKey = "5f0****************2c4"; //sdkappid 对应的 appkey,需要业务方高度保密
string strRand = "7226249334"; //URL 中的 random 字段的值
string strTime = "1457336869"; //UNIX 时间戳
string sig = sha256(appkey=5f03a3*************8186a2c4&random=7226249334&time=1457336869&mobile=13788888888)
= ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4;

响应参数

{
"result": 0,
"errmsg": "OK",
"callid": "xxxx",
"ext": ""
}
参数
必选
类型
描述
result
是
number
错误码,0表示成功(计费依据),非0表示失败。
errmsg
是
string
错误消息,result 非0时的具体错误信息。
callid
否
string
标识本次发送 ID,标识一次下发记录。
ext
否
string
用户的 session 内容,腾讯 server 回包中会原样返回。

Demo

腾讯云语音消息为您提供了 Java SDK、PHP SDK、Python SDK、Node.js SDK 和 C# SDK 供您参考,欢迎查阅。