下载等待音乐文件

获取等待音乐播放列表中指定音频文件的下载资源 URL，然后访问该 URL 下载音频文件。

请求 URL

GET {base_url}/{api_path}/moh_files/download?list_name={list_name}&file={file}&access_token={access_token}

请求参数


参数	是否必填	类型	说明
list_name	是	String	查询等待音乐播放列表的名称。注：可使用查询等待音乐列表接口查询等待音乐播放列表的名称。
file	是	String	等待音乐文件的名称，包含文件扩展名 (如 "WhisperingPine.wav")。注：可使用查询等待音乐文件列表接口查询等待音乐文件的名称。

响应参数


参数	类型	说明
errcode	Integer	返回错误码。 `0`：请求成功。非零值：请求失败。注：更多错误码和错误信息说明，请参见错误码 & 错误信息。
errmsg	String	返回信息。 `SUCCESS`：请求成功。 `FAILURE`：请求失败。
file	String	等待音乐文件名称。
download_resource_url	String	等待音乐文件的下载资源 URL。

示例

请求示例

GET /openapi/v1.0/moh_files/download?list_name=demo_list&file=demo_track.wav&access_token=gwakjgu9ZBUfz36wql4ndsVKkryI0kdj HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com

响应示例

HTTP/1.1 200 OK
{
  "errcode": 0,
  "errmsg": "SUCCESS",
  "file": "demo_track.wav",
  "download_resource_url": "/api/download/P550-MohPrompt-37.24.0.117-download-20260914165139-XCLciWr6CHloEPOu.wav"
}

将下载资源 URL 与 {base_url} 组合，然后使用组合后的完整链接下载等待音乐文件。

下载链接格式

{base_url}/{download_resource_url}

下载链接示例

https://yeastardocs.example.yeastarcloud.com//api/download/P550-MohPrompt-37.24.0.117-download-20260914165139-XCLciWr6CHloEPOu.wav