
# 获取录音文件地址 (getRecordingAddress)
#### 场景描述
获取录音地址。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/CC-Management/v1/mobileAgent/getRecordingAddress，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                            |
|:---|:---|:---|:---|:---|
| 1  | X-APP-Key     | string | False | 用户标识，与tokenByAkSk接口请求参数中的app_key一致                            |
| 2  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号 | 名称           | 参数类型   | 是否必选 | 说明                                                                                                                           |
|:---|:---|:---|:---|:---|
| 1  | callSerialNo | string | True | 呼叫流水号 长度限制：string（50） |
   
#### 响应说明
- **响应状态码: 200**
表3响应体参数 
| 序号    | 名称      | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|:---|
| 1.1   | retCode | number | True  | 返回码。0表示成功，其他为失败。 1：上传OBS失败 3：VDN不可用 5：无对应历史记录 6：虚拟呼叫中心不存在 7：sftp信息为空 8：sftp用户密码为空 9：sftp连接失败 10：获取临时路径失败 11：从UAP下载文件失败 12：呼叫流水号长度不可大于50 13：录音文件大小超过限制 |
| 1.2   | retMsg  | string | True  | 失败原因的描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 1.3   | result  | object | False | 返回结果                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.3.1 | url     | string | False | 录音地址url，获取的录音地址url有效期为5分钟。 长度限制：string（200）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数。
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  \>
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
x-app-key:6******************************b  
Authorization:Bearer e******************************6   
Content-Type:application/json
```
请求参数:
```
{
"callSerialNo": "679218118865715226"
}
```
响应头:
```
{
"connection": "keep-alive",
"content-type": "application/json;charset=UTF-8"
}
```
响应参数:
```
{
"retMsg": "success",
"result": {
"url": "https://10.10.10.1:28090/service-cloud/fscomponent/cc-management?hashKey=GhVvqXacMj26WICeWbyB"
},
"retCode": "0"
}
```
