下载录音文件

下载特定的通话录音文件。

下载步骤

请求 URL

GET {base_url}/{api_path}/recording/download?access_token={access_token}

请求参数

参数 是否必填 类型 说明
id Integer 通话录音的唯一 ID。
注: 可使用 查询录音列表 接口查询通话录音 ID。
file String 通话录音文件名。

响应参数

1.
参数 类型 说明
errcode Integer 返回错误码。
  • 0:请求成功。
  • 非零值:请求失败。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息
errmsg String 返回信息。
  • SUCCESS:请求成功。
  • FAILURE:请求失败。
file String 通话录音文件名。
download_resource_url String 通话录音文件下载 URL。
注: 下载 URL 的有效时长为 30 分钟。

示例

请求示例

使用 ID 获取通话录音文件下载 URL。

GET /openapi/v1.0/recording/download?id=1727&access_token=WQMR0cuirhX264oZMa9pV03T9li924NS HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "file": "20220412173331-1649756009.12-2002-2005-Internal.wav",
    "download_resource_url": "/api/download/Recording-X.7.0.6-1-download-20220412175901-M8zB66xYUNTNMr2D.wav"
}

下载通话录音文件

在获取通话录音文件下载 URL 后,你需要将下载 URL 与 {base_url} 整合,组成一个下载请求 URL,并发送请求下载通话录音文件。

下载链接格式

GET {base_url}/{download_resource_url}?access_token={access_token}

下载链接示例

GET https://yeastardocs.example.yeastarcloud.com/api/download/Recording-X.7.0.6-1-download-20220412175901-M8zB66xYUNTNMr2D.wav?access_token=WQMR0cuirhX264oZMa9pV03T9li924NS HTTP/1.1