发送语音验证码

最近更新时间:2020-12-24 16:11:23

接口描述

功能描述

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

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 = "5f03a35d00ee52a21327ab048186a2c4"; //sdkappid 对应的 appkey,需要业务方高度保密
string strRand = "7226249334"; //URL 中的 random 字段的值
string strTime = "1457336869"; //UNIX 时间戳
string sig = sha256(appkey=5f03a35d00ee52a21327ab048186a2c4&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 SDKPHP SDKPython SDKNode.js SDKC# SDK 供您参考,欢迎查阅。