编辑等待音乐文件

重命名指定等待音乐播放列表中的等待音乐文件。

请求 URL

POST {base_url}/{api_path}/moh_files/updatefile?access_token={access_token}

请求参数

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

可使用 查询等待音乐文件列表 接口查询等待音乐文件的名称。

new_file 是 String 等待音乐文件的新名称,包含文件扩展名 (如 "WhisperingPine.wav")。
注:
  • 文件扩展名必须与旧文件相同。
  • 新文件名不能与同一等待音乐播放列表中已有的文件名称重复。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0:请求成功。
  • 非零值:请求失败。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS:请求成功。
  • FAILURE:请求失败。

示例

请求示例

POST /openapi/v1.0/moh_files/updatefile?access_token=gwakjgu9ZBUfz36wql4ndsVKkryI0kdj HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json
{
  "list_name": "demo_list",
  "old_file": "demo_track.wav",
  "new_file": "demo_track_v2.wav"
}

响应示例

HTTP/1.1 200 OK
{
  "errcode": 0,
  "errmsg": "SUCCESS"
}