下载录音文件

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

注：
  • 如果启用了 录音左右声道分离功能 功能 (在 PBX 管理网页上的 呼叫功能 > 录音 中设置)，则所有录音文件都将以指定的格式下载。
  • 如果录音文件的下载格式被设置为 .mp3，则通过该接口下载录音文件的并发请求上限为 1。

下载步骤

  1. 使用 ID 或文件名称获取通话录音文件的下载链接
  2. 下载通话录音文件

请求 URL

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

请求参数

参数 是否必填 类型 说明
id 否 Integer 通话录音的唯一 ID。
注：
  • 可使用 搜索特定录音 接口查询通话录音 ID。
  • id 和 file 二者必填其一。
file 否 String 通话录音文件名。
注： id 和 file 二者必填其一。

响应参数

参数 类型 说明
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 后，你需要将其与 {base_url} 结合，并添加 {access_token} 参数，然后使用此完整的下载链接获取所需文件。

下载链接格式

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

下载链接示例

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