上传IVR语音文件（importVoiceFile/upload）
场景描述
上传IVR语音文件。
该接口有性能限制：每秒请求10次之后会进行流量控制（超过限制后请求会失败）。
接口方法
POST
接口URI
https://域名/apiaccess/rest/cc-management/v1/importVoiceFile/upload，例如域名是service.besclouds.com
请求说明
|
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
1 |
Authorization |
string |
True |
鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
|
2 |
X-APP-Key |
string |
False |
appKey字段，用户标识，请联系运营人员获取appKey |
|
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
1 |
body |
object |
False |
- |
|
1.1 |
fileInfo |
string |
True |
Base64编码后的录音文件信息，限制8MB。上传文件大小会相应增加上传时间 |
|
1.2 |
locale |
string |
True |
录音文件的语种，zh_CN(中文)、en_US(英文)、pt_BR(葡萄牙语)、th_TH(泰语) |
|
1.3 |
voiceType |
string |
True |
语音类型，比如0 是IVR，1提示音，2故障音，3语音通知 |
|
1.4 |
fileType |
string |
True |
文件类型，支持wav格式和MP3格式 wav格式和MP3格式均会使用ffmpeg工具转码为平台所支持的音频文件格式（A-law压缩算法、单声道、采样位数:8bit、采样频率:8000HZ），转换后音质可能会有影响，音频文件数据可能会丢失，建议使用符合平台支持的音频文件格式。 |
|
1.5 |
callBackUrl |
string |
False |
回调URL，系统审核后，系统会通过这个url返回审核的结果信息。 回调URL为客户自定义接口，用于接收系统审核结果信息，其中请求参数与响应参数可参考表3。 回调URL已通过系统管理员加入IVR语音上传回调的地址白名单中。 URL格式参考如下：https://support.huaweicloud.com/productdesc-cec/cec_01_0001.html |
|
1.6 |
voiceFileName |
string |
False |
IVR语音名称，长度不能超过50字符，只能包含中文、大小写字母，数字。 |
|
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
请求参数 |
||||
|
1.5.1 |
fileUrl |
string |
True |
审核文件地址，文件地址全称，包括文件后缀。 |
|
1.5.2 |
fileId |
string |
True |
审核文件ID，具体值可参考表4中的fileId字段设置。 |
|
1.5.3 |
status |
string |
True |
|
|
1.5.4 |
comment |
string |
False |
审核状态备注。 |
|
响应参数 |
||||
|
1.5.5 |
returnCode |
string |
True |
响应代码，取值范围：
|
响应说明
- 响应状态码: 200
- 响应状态码: 404
请求的内容未找到：请检查请求的路径。
- 响应状态码: 500
业务失败：请依次确认您请求中各参数的取值
错误码
无。
报文样例
请求头:
Content-Type:application/json Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX X-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX
请求参数:
{
"locale" : "zh_CN",
"voiceType" : "0",
"fileType" : "wav",
"callBackUrl" : "http://10.130.40.194:18133/upload",
"fileInfo" :
"UklGRjJ+AABXQVZFZm10IBIAAAAGAAEAQB8AAEAfAAABAAgAAABkYXRhAH4AANXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1dXV1"
}
响应参数:
{
"returnCode": "0",
"description": "File uploaded successfully.",
"fileId": "1182733043937561608"
}
回调URL样例报文：
//请求参数
{
"fileUrl": "Y:/IVR/147/voice/0/nPqV9vU3_1666706957559.wav",
"fileId": "1323606152730207249",
"status": "2",
"comment": "审核通过"
}
//响应参数
{
"returnCode": "0"
}
