文档首页/云客服/API参考/系统配置类接口参考（API Fabric）/移动座席和双呼功能集成/获取录音文件地址 (getRecordingAddress)
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

获取录音文件地址 (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"
}