# 录音下载和播放URL接口
#### 场景描述
调用该接口，将CC-FS侧的录音文件上传到OBS/LSS，再从OBS/LSS获取录音下载和播放的路径。
- 前提条件：录音文件已经通过定时任务同步到CCFS侧的数据库。
- 使用限制 开发者只能下载自己帐号下的录音，开发者帐号（ak）和录音记录（callId）必须对应。
  开发者账号（ak）包含在鉴权认证字符串中，详见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。
  callId、beginTime、endTime必须唯一确定一条录音。
  
 
#### 接口方法
POST
#### 接口URI
https://ip:port/CCFS/resource/ccfs/getRecordFileUrlFromObs
其中，ip为CC-FS安装的服务器IP地址，port为CC-FS的HTTPS端口号。
如果经过NSLB路由，ip为NSLB的服务器IP地址，port为CC-FS服务在NSLB映射的HTTPS端口号。
#### 请求说明
表1请求Headers参数说明 
| 参数名称          | 选取原则 | 参数类型   | 默认值 | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|
| Content-Type  | 必选   | String | 无   | 固定填 application/json;charset=UTF-8。                                                                                           |
| Authorization | 必选   | String | 无   | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 |
   
表2请求Body参数说明 
| 参数名称      | 选取原则 | 参数类型         | 默认值 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|:---|
| callId    | 必选   | String（1-25） | 无   | 呼叫标识Id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| beginTime | 必选   | String       | 无   | 录音记录的起始时间。格式为：yyyy-MM-dd HH:mm:ss。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| endTime   | 必选   | String       | 无   | 录音记录的截止时间。格式为：yyyy-MM-dd HH:mm:ss。 录音记录的截止时间与起始时间跨度不能超过3天。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| version   | 可选   | String       | 无   | 当前接口版本，此版本为2.0。 须知： - 东八区以外的其他时区："录音记录的起始时间"和"录音记录的截止时间"两个参数需填入当前租间所在时区时间，且当前参数（version）必填。  - 东八区时区： - "录音记录的起始时间"和"录音记录的截止时间"两个参数填写0时区时间，当前参数（version）可不填。 例如，您现在位于中国（东八区），您希望查询的开始时间为2022-01-02 10:00:00，那么"录音记录的起始时间"参数应该填入的值为2022-01-02 02:00:00。   - "录音记录的起始时间"和"录音记录的截止时间"两个参数填写租间所在时区时间，当前参数（version）必填。     |
   
#### 响应说明
表3响应消息参数说明 
| 参数名称       | 参数类型   | 说明                                                                                                                                                                                                                                       |
|:---|:---|:---|
| resultCode | String | 请求返回的结果码。 0：表示成功 其他：失败 |
| resultDesc | String | 请求结果描述，详见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0835.html#ZH-CN_TOPIC_0000002481113938)。                                                                                                                            |
| resultData | Object | 请求响应数据。                                                                                                                                                                                                                                  |
| url        | String | 调用本接口成功后，从OBS/LSS返回的录音播放和下载路径，失效时间默认8小时。 如果一个callid有多个录音文件，将会返回多个录音文件的播放和下载路径，url按开始时间和结束时间顺序排序。                              |
   
#### 错误码
请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0835.html#ZH-CN_TOPIC_0000002481113938)
#### 报文样例
- 请求头
  ```
  POST /CCFS/resource/ccfs/getRecordFileUrlFromObs HTTP/1.1
  Authorization: ************
  Accept: */*
  Host: 10.154.198.164
  Content-Type: application/json;charset=UTF-8
  Content-Length: 185
  ```
  
- 请求参数
  ```
  {
      "callId": "1637742300-27",
      "beginTime": "2021-11-24 06:25:03",
      "endTime": "2021-11-25 06:25:11",
      "version": "2.0"
  }
  ```
  
- 响应头
  ```
  HTTP/1.1 200 OK
  Content-Type: application/json;charset=UTF-8
  Date: Mon, 02 Jul 2018 02:43:03 GMT
  ```
  
- 响应参数
  ```
  {
      "resultData": {
          "url": "https://south-aicc-develop.obs.cn-south-1.myhuaweicloud.com:443/ccfs/record/developId/13ddcde6-2072-40d2-b96f-58cac16e18f5?AccessKeyId=************&Expires=1637936620&Signature=************"
      },
      "resultCode": "0",
      "resultDesc": "success"
  }
  ```