语音文件验证码外呼
提交方式:
接口数据输入输出均采用JSON格式封装的字符串,编码(对整个请求的字符串编码)统一为UTF-8,采用post方式提交请求
功能:
提交自定义提示音文件名和验证码文本,系统使用客户自定义提示音播放该验证码。自定义提示音文件需提前上传至大汉语音平台。
文件格式要求:wav格式的文件,位速 128kbps,音频采样大小16位,频道 1(单声道),音频采样级别 8 kHz,音频格式 PCM,这样能保证放音的清晰度。
请求参数:
参数值说明:以下json内容为提交请求数据格式
{
"account":"dh****",
"password":"0243614f784a8cfa94a94b85cbee7540",
"data":[{
"msgid":"49a5f1d78ab84b90a963beac04867b73",
"callee":"157****6131",
"medianame":"myverifycodefilename_1",
"text":"255178",
"calltype":1,
"playmode":3
},{
"msgid":"49a5f1d78ab84b90a963beac04867b74",
"callee":"157****6132",
"medianame":"myverifycodefilename_2",
"text":"211456",
"calltype":1,
"playmode":3
}]
}
示例解释:上述请求一共提交了两条验证码语音消息内容。对于用户157****6131,系统将先播放提示音myverifycodefilename_1再播放text中的验证码内容255178。而用户157****6132,系统将先播放提示音myverifycodefilename_2再播放text中的验证码内容211456。
参数名 | 说明 |
---|---|
account | 用户账号 |
password | 账号密码,需采用MD5加密(32位小写) |
msgid | 消息编号ID,必须唯一,不可为空,最大长度64位 |
callee | 被叫号码。只能有一个号码 |
medianame | 自定义验证码播放提示音的语音文件名称(不带扩展名) |
text | 验证码内容,只允许4~8位的数字验证码 |
playmode | 放音模式:3-先播放语音文件,再播放文本 |
calltype | 外呼类型: 1-验证码呼叫 |
返回示例:
{
"result":"DH:1004",
"desc":"存在无效号码/限制运营商号码",
"data":[{
"status":"DH:1004",
"desc":"存在无效号码/限制运营商号码",
"msgid":"49a5f1d78ab84b90a963beac04867b74",
"callee":"157****6132"
}]
}
示例解释:外呼请求的响应一般只会返回result,只有存在错误数据时才会返回data,status是错误码(提交响应码),desc是错误描述。
返回参数说明:
参数名 | 说明 |
---|---|
result | 总的提交结果状态码 |
desc | 提交结果描述下列为响应中可能携带的具体消息的参数(可多条) |
status | 状态码 |
desc | 描述 |
msgid | 消息编号 |
callee | 被叫号码 |
文档更新时间: 2024-08-28 09:08 作者:admin