返回提交历史
Modified
README.md
+2
-2
Modified
music/info.md
+42
-32
Added
music/music_list.md
+270
-0
XFEstudio/bilibili-API-collect
添加音频收藏夹相关
b4b1090
代码差异
3 个文件
+314
-34
@@ -6,7 +6,7 @@
6
6
7
7
**不断更新中....**
8
8
9
本项目对B站web端散落在世界各地的野生api进行收集整理，以及研究使用方法并对其进行说明，运用了黑箱法、控制变量法、js逆向分析法等研究办法
9
本项目对B站web端以及移动端散落在世界各地的野生api进行收集整理，以及研究使用方法并对其进行说明，运用了黑箱法、控制变量法、js逆向分析法等研究办法
10
10
11
11
所有api均为标准http协议，返回值大都为json
12
12
@@ -56,10 +56,10 @@
56
56
- 文集基本信息
57
57
- [音频](music)
58
58
- [歌曲基本信息](music/info.md)√
59
- [歌单&音频收藏夹详细信息](music/music_list.md)×
59
60
- [状态数](music/status_number.md)×
60
61
- [投币&收藏](music/coin&fav.md)×
61
62
- 播放&下载地址（音频流）
62
- 歌单相关
63
63
- 音频榜单
64
64
- [排行榜&最新动态](ranking&dynamic)
65
65
- [排行榜](ranking&dynamic/ranking.md)x
@@ -24,33 +24,33 @@
24
24
25
25
`data`对象：
26
26
27
| 字段 | 类型 | 内容 | 备注 |
28
| ---------- | ------ | ------------ | ---------------- |
29
| id | num | 音频auID | |
30
| uid | num | UP主UID | |
31
| uname | str | UP主昵称 | |
32
| author | str | 作者名 | |
33
| title | str | 歌曲标题 | |
34
| cover | str | 封面图片url | |
35
| intro | str | 歌曲简介 | |
36
| lyric | str | lrc歌词url | |
37
| crtype | num | 1 | **作用尚不明确** |
38
| duration | num | 歌曲时间长度 | 单位为秒 |
39
| passtime | num | 歌曲发布时间 | 时间戳 |
40
| curtime | num | 当前请求时间 | 时间戳 |
41
| aid | num | 关联视频avID | 无为0 |
42
| bvid | str | 关联视频bvID | 无为空 |
43
| cid | num | 关联视频CID | 无为0 |
44
| msid | num | 0 | **作用尚不明确** |
45
| attr | num | 0 | **作用尚不明确** |
46
| limit | num | 0 | **作用尚不明确** |
47
| activityId | num | 0 | **作用尚不明确** |
48
| limitdesc | str | 空 | **作用尚不明确** |
49
| ctime | null | - | **作用尚不明确** |
50
| statistic | obj | 状态数 | |
51
| vipInfo | obj | UP主会员状态 | |
52
| collectIds | arrary | 空 | **作用尚不明确** |
53
| coin_num | num | 投币数 | |
27
| 字段 | 类型 | 内容 | 备注 |
28
| ---------- | ------ | ------------------ | ------------------ |
29
| id | num | 音频auID | |
30
| uid | num | UP主UID | |
31
| uname | str | UP主昵称 | |
32
| author | str | 作者名 | |
33
| title | str | 歌曲标题 | |
34
| cover | str | 封面图片url | |
35
| intro | str | 歌曲简介 | |
36
| lyric | str | lrc歌词url | |
37
| crtype | num | 1 | **作用尚不明确** |
38
| duration | num | 歌曲时间长度 | 单位为秒 |
39
| passtime | num | 歌曲发布时间 | 时间戳 |
40
| curtime | num | 当前请求时间 | 时间戳 |
41
| aid | num | 关联视频avID | 无为0 |
42
| bvid | str | 关联视频bvID | 无为空 |
43
| cid | num | 关联视频CID | 无为0 |
44
| msid | num | 0 | **作用尚不明确** |
45
| attr | num | 0 | **作用尚不明确** |
46
| limit | num | 0 | **作用尚不明确** |
47
| activityId | num | 0 | **作用尚不明确** |
48
| limitdesc | str | 空 | **作用尚不明确** |
49
| ctime | null | - | **作用尚不明确** |
50
| statistic | obj | 状态数 | |
51
| vipInfo | obj | UP主会员状态 | |
52
| collectIds | arrary | 歌曲所在的收藏夹ID | 需要登录(SESSDATA) |
53
| coin_num | num | 投币数 | |
54
54
55
55
`data`中的`statistic`对象：
56
56
@@ -71,6 +71,14 @@
71
71
| due_date | num | 会员到期时间 | 时间戳 毫秒 |
72
72
| vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
73
73
74
`data`中的`collectIds`数组：
75
76
| 项 | 类型 | 内容 | 备注 |
77
| ---- | ---- | ------------------------- | ---- |
78
| 0 | num | 第1个所在的收藏夹ID | |
79
| n | num | 第（n+1）个所在的收藏夹ID | |
80
| …… | num | …… | …… |
81
74
82
**示例：**
75
83
76
84
查询音频`au13598`的基本信息
@@ -93,7 +101,7 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
93
101
"crtype": 1,
94
102
"duration": 239,
95
103
"passtime": 1501640683,
96
"curtime": 1589951574,
104
"curtime": 1590154258,
97
105
"aid": 2554020,
98
106
"bvid": "BV1us411S7E6",
99
107
"cid": 3990196,
@@ -105,9 +113,9 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
105
113
"ctime": null,
106
114
"statistic": {
107
115
"sid": 13598,
108
"play": 1027436,
109
"collect": 30892,
110
"comment": 520,
116
"play": 1028516,
117
"collect": 30914,
118
"comment": 523,
111
119
"share": 384
112
120
},
113
121
"vipInfo": {
@@ -116,7 +124,9 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
116
124
"due_date": 1620316800000,
117
125
"vip_pay_type": 0
118
126
},
119
"collectIds": [],
127
"collectIds": [
128
15967839
129
],
120
130
"coin_num": 1777
121
131
}
122
132
}
@@ -0,0 +1,270 @@
1
# 歌单&音频收藏夹详细信息
2
3
## 查询自己创建的歌单
4
5
> https://www.bilibili.com/audio/music-service-c/web/collections/list
6
7
*方式：GET*
8
9
需要登录(SESSDATA)及验证DedeUserID存在且不为0
10
11
**参数：**
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ------ | ---- | -------- | ------ | ---- |
15
| pn | url | 页码 | 必要 | |
16
| ps | url | 每页项数 | 必要 | |
17
18
**json回复：**
19
20
根对象：
21
22
| 字段 | 类型 | 内容 | 备注 |
23
| ---- | ----------------------------- | -------- | ----------------------------------------------------- |
24
| code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：未登录 |
25
| msg | str | 错误信息 | 默认为success |
26
| data | 正确时：obj<br />错误时：null | 信息本体 | |
27
28
`data`对象：
29
30
| 字段 | 类型 | 内容 | 备注 |
31
| --------- | ------ | ------------ | ---- |
32
| curPage | num | 当前页码 | |
33
| pageCount | num | 总计页数 | |
34
| totalSize | num | 总计收藏夹数 | |
35
| pageSize | num | 当前页面项数 | |
36
| data | arrary | 歌单列表 | |
37
38
`data`中的`data`数组：
39
40
| 项 | 类型 | 内容 | 备注 |
41
| ---- | ---- | ----------------- | ---- |
42
| 0 | obj | 音频收藏夹ID1 | |
43
| n | obj | 音频收藏夹ID(n+1) | |
44
| …… | obj | …… | …… |
45
46
`data`数组中的对象：
47
48
| 字段 | 类型 | 内容 | 备注 |
49
| --------- | ------ | ------------------------ | -------------------------------- |
50
| id | num | 音频收藏夹ID | |
51
| uid | num | 创建用户UID | |
52
| uname | str | 创建用户昵称 | |
53
| title | str | 歌单标题 | |
54
| type | num | 收藏夹属性 | 0：普通收藏夹<br />1：默认收藏夹 |
55
| published | num | 是否公开 | 0：不公开<br />1：公开 |
56
| cover | str | 歌单封面图片url | |
57
| ctime | num | 歌单创建时间 | 时间戳 |
58
| song | num | 歌单中的音乐数量 | |
59
| desc | str | 歌单备注信息 | |
60
| sids | arrary | 歌单中的音乐 | |
61
| menuId | num | 音频收藏夹对应的歌单amID | |
62
| statistic | obj | 歌单状态数信息 | |
63
64
`data`中的`sids`数组：
65
66
| 项 | 类型 | 内容 | 备注 |
67
| ---- | ---- | ------------------- | ---------------- |
68
| 0 | num | 收藏的音频auID1 | |
69
| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 |
70
| …… | num | …… | …… |
71
72
`data`中的`statistic`对象：
73
74
| 字段 | 类型 | 内容 | 备注 |
75
| ------- | ---- | ------------------------ | ---- |
76
| sid | num | 音频收藏夹对应的歌单amID | |
77
| play | num | 播放次数 | |
78
| collect | num | 点赞次数 | |
79
| comment | null | - | |
80
| share | num | 分享次数 | |
81
82
**示例：**
83
84
http://www.bilibili.com/audio/music-service-c/web/collections/list?pn=1&ps=2
85
86
共计创建了两个歌单，如下
87
88
```json
89
{
90
"code": 0,
91
"msg": "success",
92
"data": {
93
"curPage": 1,
94
"pageCount": 1,
95
"totalSize": 2,
96
"pageSize": 2,
97
"data": [
98
{
99
"id": 15967839,
100
"uid": 293793435,
101
"uname": "社会易姐QwQ",
102
"title": "默认歌单",
103
"type": 1,
104
"published": 1,
105
"cover": "http://i0.hdslb.com/bfs/music/1e079693701d2f525850c288fcc48fa4259a73f6.jpg",
106
"ctime": 1519295502,
107
"song": 13,
108
"desc": "",
109
"sids": [
110
11673,
111
276404,
112
15664,
113
737904,
114
108588,
115
1286999,
116
658085,
117
682118,
118
736952,
119
48716,
120
15711,
121
13598,
122
57744
123
],
124
"menuId": 15958713,
125
"statistic": {
126
"sid": 15958713,
127
"play": 0,
128
"collect": 0,
129
"comment": null,
130
"share": 0
131
}
132
},
133
{
134
"id": 30894022,
135
"uid": 293793435,
136
"uname": "社会易姐QwQ",
137
"title": "test",
138
"type": 0,
139
"published": 1,
140
"cover": "",
141
"ctime": 1590154346,
142
"song": 0,
143
"desc": "test1",
144
"sids": [],
145
"menuId": 30866686,
146
"statistic": {
147
"sid": 30866686,
148
"play": 0,
149
"collect": 0,
150
"comment": 0,
151
"share": 0
152
}
153
}
154
]
155
}
156
}
157
```
158
159
160
161
## 查询音频收藏夹（默认歌单）信息
162
163
> https://www.bilibili.com/audio/music-service-c/web/collections/info
164
165
*方式：GET*
166
167
需要登录(SESSDATA)及验证DedeUserID存在且不为0
168
169
**参数：**
170
171
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
172
| ------ | ---- | ------------ | ------ | ------------------ |
173
| sid | url | 音频收藏夹ID | 必要 | 必须为默认收藏夹ID |
174
175
**json回复：**
176
177
根对象：
178
179
| 字段 | 类型 | 内容 | 备注 |
180
| ---- | ----------------------------- | -------- | ----------------------------------------------------- |
181
| code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：未登录 |
182
| msg | str | 错误信息 | 默认为success |
183
| data | 正确时：obj<br />错误时：null | 信息本体 | |
184
185
`data`对象：
186
187
| 字段 | 类型 | 内容 | 备注 |
188
| --------- | ------ | ------------------------ | ---------------------- |
189
| id | num | 音频收藏夹ID | |
190
| uid | num | 创建用户UID | |
191
| uname | str | 创建用户昵称 | |
192
| title | str | 默认歌单 | 恒为`默认歌单` |
193
| type | num | 1 | 恒为`1` |
194
| published | num | 是否公开 | 0：不公开<br />1：公开 |
195
| cover | str | 歌单封面图片url | |
196
| ctime | num | 歌单创建时间 | 时间戳 |
197
| song | num | 歌单中的音乐数量 | |
198
| desc | str | 空 | 恒为空 |
199
| sids | arrary | 歌单中的音乐 | |
200
| menuId | num | 音频收藏夹对应的歌单amID | 与普通歌单不同通用 |
201
| statistic | obj | 歌单状态数信息 | |
202
203
`data`中的`sids`数组：
204
205
| 项 | 类型 | 内容 | 备注 |
206
| ---- | ---- | ------------------- | ---------------- |
207
| 0 | num | 收藏的音频auID1 | |
208
| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 |
209
| …… | num | …… | …… |
210
211
`data`中的`statistic`对象：
212
213
| 字段 | 类型 | 内容 | 备注 |
214
| ------- | ---- | ------------------------ | ---- |
215
| sid | num | 音频收藏夹对应的歌单amID | |
216
| play | num | 0 | |
217
| collect | num | 0 | |
218
| comment | null | - | |
219
| share | num | 0 | |
220
221
**示例：**
222
223
查询我的默认歌单，ID为` 15967839 `
224
225
https://www.bilibili.com/audio/music-service-c/web/collections/info?sid=15967839
226
227
```json
228
{
229
"code": 0,
230
"msg": "success",
231
"data": {
232
"id": 15967839,
233
"uid": 293793435,
234
"uname": "社会易姐QwQ",
235
"title": "默认歌单",
236
"type": 1,
237
"published": 1,
238
"cover": "http://i0.hdslb.com/bfs/music/1e079693701d2f525850c288fcc48fa4259a73f6.jpg",
239
"ctime": 1519295502,
240
"song": 13,
241
"desc": "",
242
"sids": [
243
11673,
244
276404,
245
15664,
246
737904,
247
108588,
248
1286999,
249
658085,
250
682118,
251
736952,
252
48716,
253
15711,
254
13598,
255
57744
256
],
257
"menuId": 15958713,
258
"statistic": {
259
"sid": 15958713,
260
"play": 0,
261
"collect": 0,
262
"comment": null,
263
"share": 0
264
}
265
}
266
}
267
```
268
269
270