发送语音验证码

接口描述

功能描述

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

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 SDK、PHP SDK、Python SDK、Node.js SDK 和 C# SDK 供您参考，欢迎查阅。