根据标签获取歌曲

---

1 描述

本接口调用需通过 获取标签列表 中的标签 ID，可获取对应的歌曲 ID、歌曲名、歌曲专辑、以及版权相关信息等。

2 接口原型

• 请求方法：GET
• 请求地址：https://ktv-api.zego.im/?Action=DescribeTagSongs
• 传输协议：HTTPS
• 调用频率限制：200 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考 调用方式 - 公共请求参数。

4 请求示例

https://ktv-api.zego.im/?Action=DescribeTagSongs
&TagId=1107
&Page=1
&Filter[]=1
&Filter[]=3
&<公共请求参数>

以上示例表示：根据标签 ID 是 1107，通过过滤选项 1 和 3，筛选出有词曲版权且含有歌词的歌曲，展示列表第一页的内容。

5 响应参数

其中参数 Data：

其中参数 Songs：

其中参数 Copyright：

6 响应示例

{
    "Code": 0,
    "Message": "succeed",
    "RequestId": "1a6d02a8-66ba-455f-9e05-fe77da6a1f14",
    "Data": {
        "Songs": [
            {
                "SingerImg": "http://singerimg.kugou.com/uploadpic/softhead/150/20210107/20210107101003717.jpg",
                "AlbumImg": "http://imge.kugou.com/stdmusic/150/20160907/20160907184908526143.jpg",
                "AlbumImgMini": "http://imge.kugou.com/stdmusic/150/20160907/20160907184908526143.jpg",
                "AlbumImgSmall": "http://imge.kugou.com/stdmusic/240/20160907/20160907184908526143.jpg",
                "AlbumImgMedium": "http://imge.kugou.com/stdmusic/480/20160907/20160907184908526143.jpg",
                "SongId": "28341435",
                "SongName": "朋友的酒",
                "SingerName": "李晓杰",
                "AlbumName": "老大",
                "Duration": 250000,
                "HasClip": 1,
                "VendorId": 2,  // 歌曲的版权方。版权方的详细信息，请联系 ZEGO 商务人员咨询
                "PitchAbility": 1, //仅当 VendorId 为 2 时，才会返回此字段
                "Copyright": {
                    "SongLyric": 1,
                    "Recording": 1,
                    "Channel": 0
                }
            }
        ]
    }
}

7 返回码

以下仅列出了接口业务逻辑相关的部分返回码，完整返回码请参考 全局返回码。