mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-29 14:00:09 +08:00

* https统一写作http

* 勘误

2021-12-17 10:26:13 +08:00

11 KiB

Raw Blame History

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

歌单&音频收藏夹详细信息
- 查询自己创建的歌单
- 查询音频收藏夹（默认歌单）信息
歌单&音频收藏夹详细信息
- 查询自己创建的歌单
- 查询音频收藏夹（默认歌单）信息

查询自己创建的歌单

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	音频收藏夹mlid1
n	obj	音频收藏夹mlid(n+1)
……	obj	……	……

data数组中的对象：

字段	类型	内容	备注
id	num	音频收藏夹mlid
uid	num	创建用户mid
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
                }
            }
        ]
    }
}

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

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