下载录音文件（扩展）
场景描述
调用该API，可以通过callid或fileName查询并下载录音文件。
使用对象：提供给第三方后台调用，可用于转储等场景。
使用说明
- 前提条件
- 已调用“下载话单和录音索引”获取录音索引文件。
- 已通过鉴权（Authorization）、获取接入地址。
- 使用限制
开发者只能下载自己帐号下的文件，开发者帐号（appId）和录音原始文件名称（fileName）必须对应。
开发者账号（appId）包含在鉴权认证字符串中，详见C2 监控/系统外呼/话单/知识库类接口鉴权方式。
接口方法
POST
接口URI
https://ip:port/CCFS/resource/ccfs/downloadRecord
其中，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 |
fileName |
String（1-225） |
False |
无 |
录音文件名，从调用“下载话单和录音索引”时返回的录音索引文件中的original_file_name 字段获取 比如:“X:/4/0/20180416/512/1629533.V3”。注：fileName和callId参数值必须至少选填一个。 |
2 |
callId |
String（1-25） |
False |
无 |
呼叫标识Id。注：fileName和callId参数值必须至少选填一个，callid 对应多个录音文件会下载 zip 压缩包。 |
3 |
ccId |
String（1-64） |
False |
无 |
呼叫中心Id。当前环境默认为“1”。 |
响应说明
当调用本接口响应成功，则从httpresonse消息中获取文件的二进制数据生成录音文件，文件后缀名为.wav，通过callid下载多个录音文件后缀名为.zip，响应中content-type字段为Application/Octet-stream;charset=UTF-8。
当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表4，resultData为保留字段，默认为空字符串。
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
1 |
resultCode |
String |
请求返回的结果码，详见错误码参考。 |
2 |
resultDesc |
String |
请求结果描述。 |
3 |
resultData |
Object |
请求响应数据 |
4 |
response |
Object |
请求结果对象，参数说明详见表5 不推荐使用，为兼容老版本保留字段。 |
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
4.1 |
version |
String（1-32） |
协议版本，如2.0。 |
4.2 |
resultCode |
String(1-32) |
请求返回的结果码，详见错误码参考。 |
4.3 |
resultMsg |
String |
请求结果描述。 |
报文样例
- 请求头
POST /CCFS/resource/ccfs/downloadRecord HTTP/1.1 Authorization: auth-v2/ak/2018-07-02T02:44:42Z/content-length;content-type;host /f18f6dd19******************6b8ff99f6c5884 Accept: */* Host: 10.154.198.164 Content-Type: application/json;charset=UTF-8 Content-Length: 185
- 请求参数
{ "request": { "version": "2.0" }, "msgBody": { "fileName": "Y:/autoTest.V3", "callId": "autoTest-1", "ccId": "1" } }
