Skip to content

Latest commit

 

History

History
296 lines (243 loc) · 10.3 KB

music_list.md

File metadata and controls

296 lines (243 loc) · 10.3 KB
Raw

歌单&音频收藏夹详细信息

查询自己创建的歌单

http://www.bilibili.com/audio/music-service-c/web/collections/list

请求方式：GET

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中DedeUserID存在且不为0

url参数：

参数名 类型 内容 必要性 备注
pn num 页码 必要
ps num 每页项数 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
72000000：参数错误
72010002：未登录
msg str 错误信息 默认为success
data 正确时：obj
错误时：null		 信息本体

data对象：

字段 类型 内容 备注
curPage num 当前页码
pageCount num 总计页数
totalSize num 总计收藏夹数
pageSize num 当前页面项数
data array 歌单列表

data中的data数组：

项 类型 内容 备注
0 obj 音频收藏夹ID1
n obj 音频收藏夹ID(n+1)
…… obj …… ……

data数组中的对象：

字段 类型 内容 备注
id num 音频收藏夹ID
uid num 创建用户UID
uname str 创建用户昵称
title str 歌单标题
type num 收藏夹属性 0：普通收藏夹
1：默认收藏夹
published num 是否公开 0：不公开
1：公开
cover str 歌单封面图片url
ctime num 歌单创建时间 时间戳
song num 歌单中的音乐数量
desc str 歌单备注信息
sids array 歌单中的音乐
menuId num 音频收藏夹对应的歌单amID
statistic obj 歌单状态数信息

data中的sids数组：

项 类型 内容 备注
0 num 收藏的音频auID1
n num 收藏的音频auID(n+1) 按照歌单顺序排列
…… num …… ……

data中的statistic对象：

字段 类型 内容 备注
sid num 音频收藏夹对应的歌单amID
play num 播放次数
collect num 点赞次数
comment null -
share num 分享次数

示例：

curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx;DedeUserID=1;'

共计创建了两个歌单，如下

查看响应示例： 
{
    "code": 0,
    "msg": "success",
    "data": {
        "curPage": 1,
        "pageCount": 1,
        "totalSize": 2,
        "pageSize": 2,
        "data": [
            {
                "id": 15967839,
                "uid": 293793435,
                "uname": "社会易姐QwQ",
                "title": "默认歌单",
                "type": 1,
                "published": 1,
                "cover": "http://i0.hdslb.com/bfs/music/1e079693701d2f525850c288fcc48fa4259a73f6.jpg",
                "ctime": 1519295502,
                "song": 13,
                "desc": "",
                "sids": [
                    11673,
                    276404,
                    15664,
                    737904,
                    108588,
                    1286999,
                    658085,
                    682118,
                    736952,
                    48716,
                    15711,
                    13598,
                    57744
                ],
                "menuId": 15958713,
                "statistic": {
                    "sid": 15958713,
                    "play": 0,
                    "collect": 0,
                    "comment": null,
                    "share": 0
                }
            },
            {
                "id": 30894022,
                "uid": 293793435,
                "uname": "社会易姐QwQ",
                "title": "test",
                "type": 0,
                "published": 1,
                "cover": "",
                "ctime": 1590154346,
                "song": 0,
                "desc": "test1",
                "sids": [],
                "menuId": 30866686,
                "statistic": {
                    "sid": 30866686,
                    "play": 0,
                    "collect": 0,
                    "comment": 0,
                    "share": 0
                }
            }
        ]
    }
}

查询音频收藏夹（默认歌单）信息

https://www.bilibili.com/audio/music-service-c/web/collections/info

请求方式：GET

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中DedeUserID存在且不为0

url参数：

参数名 类型 内容 必要性 备注
sid num 音频收藏夹ID 必要 必须为默认收藏夹ID

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
72000000：参数错误
72010002：未登录
msg str 错误信息 默认为success
data 正确时：obj
错误时：null		 信息本体

data对象：

字段 类型 内容 备注
id num 音频收藏夹ID
uid num 创建用户UID
uname str 创建用户昵称
title str 默认歌单 恒为默认歌单
type num 1 恒为1
published num 是否公开 0：不公开
1：公开
cover str 歌单封面图片url
ctime num 歌单创建时间 时间戳
song num 歌单中的音乐数量
desc str 空 恒为空
sids array 歌单中的音乐
menuId num 音频收藏夹对应的歌单amID 与普通歌单不同通用
statistic obj 歌单状态数信息

data中的sids数组：

项 类型 内容 备注
0 num 收藏的音频auID1
n num 收藏的音频auID(n+1) 按照歌单顺序排列
…… num …… ……

data中的statistic对象：

字段 类型 内容 备注
sid num 音频收藏夹对应的歌单amID
play num 0
collect num 0
comment null -
share num 0

示例：

查询我的默认歌单，ID为15967839

curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/info' \
--data-urlencode 'sid=15967839 ' \
-b 'SESSDATA=xxx;DedeUserID=1;'
查看响应示例： 
{
    "code": 0,
    "msg": "success",
    "data": {
        "id": 15967839,
        "uid": 293793435,
        "uname": "社会易姐QwQ",
        "title": "默认歌单",
        "type": 1,
        "published": 1,
        "cover": "http://i0.hdslb.com/bfs/music/1e079693701d2f525850c288fcc48fa4259a73f6.jpg",
        "ctime": 1519295502,
        "song": 13,
        "desc": "",
        "sids": [
            11673,
            276404,
            15664,
            737904,
            108588,
            1286999,
            658085,
            682118,
            736952,
            48716,
            15711,
            13598,
            57744
        ],
        "menuId": 15958713,
        "statistic": {
            "sid": 15958713,
            "play": 0,
            "collect": 0,
            "comment": null,
            "share": 0
        }
    }
}