第三方下载录音文件
场景描述
调用该API，第三方（IVR加载定制 jar 包与第三方对接的模式）下载录音文件。
使用说明
- 前提条件
- 已通过鉴权（Authorization）。
- 使用限制
开发者只能下载路径和系统级参数“第三方下载录音路径规则”相同并且属于自己帐号下的文件，详见C2 监控/系统外呼/话单/知识库类接口鉴权方式。系统级参数“第三方下载录音路径规则”可联系系统管理员获取，获取路径：。
接口方法
POST
接口URI
https://ip:port/CCFS/resource/ccfs/ivr/downloadFile
其中，ip为CC-FS安装的服务器IP地址，port为CC-FS的HTTPS端口号。
如果经过NSLB路由，ip为NSLB的服务器IP地址，port为CC-FS服务在NSLB映射的HTTPS端口号。
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
默认值 |
说明 |
|---|---|---|---|---|---|
1 |
Content-Type |
String |
True |
无 |
固定填 application/json; charset=UTF-8。 |
2 |
Authorization |
String |
True |
无 |
生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
序号 |
名称 |
参数类型 |
是否必选 |
默认值 |
说明 |
|---|---|---|---|---|---|
1 |
version |
String（1-32） |
True |
2.0 |
协议版本。当前固定值为2.0。 |
序号 |
名称 |
参数类型 |
是否必选 |
默认值 |
说明 |
|---|---|---|---|---|---|
1 |
filePath |
String |
True |
无 |
mode 传 1，filePath 为文件所在文件夹路径，例如：Y:/voice/1/IVRrecordFile mode 不传或其他取值，filePath 必须是文件全路径，例如：Y:/voice/1/IVRrecordFile/xx.wav 说明：文件路径由系统级参数“第三方下载录音路径规则”控制，请联系系统管理员获取，获取路径：。默认值为：/voice/%VDNNO%/IVRrecordFile;/3rdfile/%VDNNO%/IVRrecordFile;/3rdfile/%VDNNO%/thirdvoicebotfile。 |
2 |
mode |
Integer |
False |
无 |
mode 为 1表示 filePath 是个目录，下载目录下唯一的文件，如果目录下不存在文件或者存在多个文件则返回失败；mode 不传或其他取值则 filePath 必须是包含文件名的全路径。 |
响应说明
当调用本接口响应成功，则从httpresponse消息中获取文件的二进制数据生成录音文件，文件后缀名为.wav，响应中content-type字段为Application/Octet-stream;charset=UTF-8。
当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表 响应消息response参数说明，resultData为保留字段，默认为空字符串。
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
1 |
resultCode |
String |
请求返回的结果码，详见错误码参考。 |
2 |
resultDesc |
String |
请求结果描述。 |
3 |
resultData |
Object |
请求响应数据 |
报文样例
- 请求头
POST /CCFS/resource/ccfs/ivr/downloadFile HTTP/1.1 Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************94941bdd106 Accept: */* Content-Type: application/json;charset=UTF-8 Content-Length: 193
- 请求参数
{ "request": { "version": "2.0" }, "msgBody": { "filePath": "Y:/3rdfile/53/thirdvoicebotfile", "mode":"1" } }
