三方歌单查询

获取QQ音乐、酷狗音乐平台授权用户的歌单信息

在【微信小程序】中，需引导用户跳转至 K 歌 H5 授权页面，完成对应音乐平台账号的登录授权。授权成功后，H5 页面会将授权票据（token）回传给小程序，小程序再使用该票据调用平台接口，拉取用户的歌单信息。

整体流程如下：

微信小程序 → 跳转 H5 授权页 → 用户登录音乐平台账号 → H5 回传授权票据 → 小程序调用接口拉取歌单

授权 H5 链接

https://kg.qq.com/playlistImportAuth/index.html?device_id=1234&client_ip=34.92.17.55

必填参数

参数名	说明
`device_id`	设备唯一标识，建议每台设备使用唯一值，便于风控与授权管理
`client_ip`	客户端 IP 地址

可选参数

参数名	说明
`ui`	页面 UI 风格，取值 `1` 或 `2`，对应两套不同的 UI 样式，默认为 `1`
`action`	跳转调用的小程序 API，可选值：`navigate`、`switch`、`relaunch`、`redirect`，默认为 `navigate`
`path`	授权成功后跳转回的小程序页面路径（需使用 `encodeURIComponent` 进行编码）

授权结果回传

方式一：postMessage 回传

授权成功后，H5 页面会通过 postMessage 将授权结果发送给小程序，数据格式如下： { state: "", token: "", openid: "", userid: "" }

方式二：path 参数拼接回传

若跳转链接中提供了 path 参数，授权成功后会自动在该路径后追加以下参数：state和 token、openid、userid

注意事项

票据有效期

QQ 音乐：授权票据（token）有效期为 1 天

酷狗音乐：授权票据（token）有效期为 180 天

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "platform": "kugou",
  "open_id": "A32EE299E73B51A0B30B9566C68BD14C",
  "access_token": "NL8QO9DCASEAK613CI1R4GCQT28CHO7FJ9F8OBQM26VL0K3QPGJBLRTJF84SAK0MPTVM5HRC88P5QSG2ARM1U5OZ",
  "device_id": "1785379223608",
  "client_ip": "34.92.17.55",
  "page": "1",
  "page_size": "20"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

"code": 0,
    "sub_code": 0,
    "msg": "请求成功",
    "data": {
        "total": 6,
        "list": [
            {
                "playlist_type": "self",
                "playlist_id": "collection_3_1767947006_2_0",
                "playlist_name": "我喜欢",
                "playlist_pic": "",
                "create_time": "1604407708",
                "update_time": "1785393843",
                "song_num": 5
            },
            {
                "playlist_type": "self",
                "playlist_id": "collection_3_1767947006_1_0",
                "playlist_name": "默认收藏",
                "playlist_pic": "",
                "create_time": "1604407707",
                "update_time": "1785381925",
                "song_num": 0
            },
            {
                "playlist_type": "self",
                "playlist_id": "collection_3_1767947006_3_0",
                "playlist_name": "test",
                "playlist_pic": "http://c1.kgimg.com/stdmusic/480/20250101/20250101070457982332.jpg",
                "create_time": "1785381860",
                "update_time": "1785381925",
                "song_num": 24
            },
            {
                "playlist_type": "fav",
                "playlist_id": "collection_3_1197733032_13_0",
                "playlist_name": "这才是打游戏要听的",
                "playlist_pic": "http://c1.kgimg.com/custom/480/20250916/20250916200925230243.jpg",
                "create_time": "",
                "update_time": "",
                "song_num": 53
            },
            {
                "playlist_type": "fav",
                "playlist_id": "collection_3_2287701133_43_0",
                "playlist_name": "没有技巧就是硬帅DJ",
                "playlist_pic": "http://c1.kgimg.com/custom/480/20250312/20250312211816975698.jpg",
                "create_time": "",
                "update_time": "",
                "song_num": 93
            },
            {
                "playlist_type": "fav",
                "playlist_id": "collection_3_2004771008_337_0",
                "playlist_name": "伤感emo | 我的心总是灰蒙蒙，像下雨的天空",
                "playlist_pic": "http://c1.kgimg.com/custom/480/20251004/20251004220940352520.jpg",
                "create_time": "",
                "update_time": "",
                "song_num": 67
            }
        ]
    }
}

获取QQ音乐、酷狗音乐平台授权用户的歌单信息#

授权 H5 链接#

必填参数#

可选参数#

授权结果回传#

方式一：postMessage 回传#

方式二：path 参数拼接回传#

注意事项#