添加等待音乐播放列表

添加等待音乐播放列表。

请求 URL

POST {base_url}/{api_path}/play_list/create?access_token={access_token}

请求参数

参数 是否必填 类型 说明
list_name 是 String 等待音乐播放列表的名称。
list_type 是 Integer 等待音乐播放列表的类型。

取值范围：

  • 1：本地音频。
  • 2：在线音频。
play_order 否 String 播放列表中等待音乐的播放顺序。

取值范围：

  • random：随机。
  • alphabetical：按字母排序。
注： 仅当 list_type 取值为 1 时，才需填写此参数。
stream_url 否 String 在线音频的 URL。
注： 仅当 list_type 取值为 2 时，才需填写此参数。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
id Integer 等待音乐播放列表的唯一 ID。

示例

请求示例

POST /openapi/v1.0/play_list/create?access_token=vtkE9as9ILt8D7zd20beBzd8dL2uTcOL HTTP/1.1  

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json
{
    "list_name": "Professional",
    "list_type": 1,
    "play_order": "random"
}

响应示例

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