文档首页/ 云客服/ API参考/ 录音/话单类/ 话单下载和录音播放下载/ 数据访问接口/ 录音下载和播放URL接口
更新时间：2023-09-27 GMT+08:00
查看PDF
分享

录音下载和播放URL接口

场景描述

调用该接口，将CC-FS侧的录音文件上传到OBS/LSS，再从OBS/LSS获取录音下载和播放的路径。

  • 前提条件：录音文件已经通过定时任务同步到CCFS侧的数据库。
  • 使用限制

    开发者只能下载自己帐号下的录音，开发者帐号（ak）和录音记录（callId）必须对应。

    开发者账号（ak）包含在鉴权认证字符串中，详见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

    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 监控/系统外呼/话单/知识库类接口鉴权方式。
表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

请求结果描述，详见错误码参考。

resultData

Object

请求响应数据。

url

String

调用本接口成功后，从OBS/LSS返回的录音播放和下载路径，失效时间默认8小时。

如果一个callid有多个录音文件，将会返回多个录音文件的播放和下载路径，url按开始时间和结束时间顺序排序。

错误码

请参见错误码参考

报文样例

  • 请求头 
    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"
}
父主题： 数据访问接口