删除自定义铃声

删除自定义铃声。

注： PBX 内置铃声不可被删除。

请求 URL

GET {base_url}/{api_path}/custom_ringtone/delete?file={file}&access_token={access_token}

请求参数

参数 是否必填 类型 说明
file 是 String 自定义铃声的文件名，包含文件扩展名 (如 "demo_ringtone.wav")。
注：
  • 可使用 搜索自定义铃声 接口查询自定义铃声的文件名。
  • 仅允许输入本地上传的自定义铃声 (type：backend) 的文件名。

响应参数

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

示例

请求示例

GET /openapi/v1.0/custom_ringtone/delete?file=doc_demo_ring.wav&access_token=gwakjgu9ZBUfz36wql4ndsVKkryI0kdj HTTP/1.1

Host: yeastardocs.example.yeastarcloud.com

响应示例

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