语音文件验证码外呼

访问地址:http://voice.3tong.net/json/voiceSms/SubmitVoc

提交方式:

接口数据输入输出均采用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