XFE Git
XFE Studio Git
Git 首页 全局搜索
XFE 主站 文档 NuGet
公开
关注 0 Fork 0 Star 0
返回提交历史

XFEstudio/bilibili-API-collect

添加若干音频相关的api

d3913bd
社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
提交于
父提交 1163771

代码差异

5 个文件 +525 -4
Modified README.md +5 -2
@@ -54,8 +54,11 @@
54 54 - [基本信息](article/info.md)×
55 55 - 点赞&投币&收藏
56 56 - 文集基本信息
57 - 音频
58 - 歌曲相关
57 - [音频](music)
58 - [歌曲基本信息](music/info.md)√
59 - [状态数](music/ststus_number.md)×
60 - [投币&收藏](music/coin&fav.md)×
61 - 播放&下载地址（音频流）
59 62 - 歌单相关
60 63 - 音频榜单
61 64 - [排行榜&最新动态](ranking&dynamic)
Modified login/member_center.md +0 -2
@@ -344,8 +344,6 @@ http://api.bilibili.com/x/member/realname/apply/status
344 344
345 345
346 346
347
348
349 347 ## 查询硬币变化情况
350 348
351 349 > http://api.bilibili.com/x/member/web/coin/log
Added music/coin&fav.md +78 -0
@@ -0,0 +1,78 @@
1 # 音频投币&收藏
2
3 **本页所有操作均需登录（SESSDATA）以及DedeUserID存在且不为0**
4
5 ## 查询音频收藏状态
6
7 > http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll
8
9 *方式:GET*
10
11 **参数：**
12
13 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
14 | ------ | ---- | -------- | ------ | ---- |
15 | sid | url | 音频auID | 必要 | |
16
17 **json回复：**
18
19 根对象：
20
21 | 字段 | 类型 | 内容 | 备注 |
22 | ---- | ---- | -------- | ------------------------------------------------------------ |
23 | code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：账号未登陆<br />7201006：该音频不存在或已被下架 |
24 | msg | str | 错误信息 | 默认为success |
25 | data | bool | 是否收藏 | false：未收藏<br />true：已收藏 |
26
27 **示例：**
28
29 查询音频`au13598`的收藏状态
30
31 http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll?sid=13598
32
33 ```json
34 {
35 "code": 0,
36 "msg": "success",
37 "data": true
38 }
39 ```
40
41
42
43 ## 查询音频投币数
44
45 > http://www.bilibili.com/audio/music-service-c/web/coin/audio
46
47 *方式:GET*
48
49 **参数：**
50
51 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
52 | ------ | ---- | -------- | ------ | ---- |
53 | sid | url | 音频auID | 必要 | |
54
55 **json回复：**
56
57 根对象：
58
59 | 字段 | 类型 | 内容 | 备注 |
60 | ---- | ---- | -------- | ------------------------------------------------------------ |
61 | code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：账号未登陆<br />7201006：该音频不存在或已被下架 |
62 | msg | str | 错误信息 | 默认为success |
63 | data | num | 投币数量 | 0为未投币，上限为2 |
64
65 **示例：**
66
67 查询音频`au13598`的投币数
68
69 http://www.bilibili.com/audio/music-service-c/web/coin/audio?sid=15664
70
71 ```json
72 {
73 "code": 0,
74 "msg": "success",
75 "data": 1
76 }
77 ```
78
Added music/info.md +386 -0
@@ -0,0 +1,386 @@
1 # 歌曲基本信息
2
3 ## 查询歌曲基本信息
4
5 > http://www.bilibili.com/audio/music-service-c/web/song/info
6
7 *方式:GET*
8
9 **参数：**
10
11 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
12 | ------ | ---- | -------- | ------ | ---- |
13 | sid | url | 音频auID | 必要 | |
14
15 **json回复：**
16
17 根对象：
18
19 | 字段 | 类型 | 内容 | 备注 |
20 | ---- | ----------------------------- | -------- | ------------------------------------------------------------ |
21 | code | num | 返回值 | 0：成功<br />72000000：参数错误<br />7201006：该音频不存在或已被下架<br />72010027：版权音乐重定向 |
22 | msg | str | 错误信息 | 默认为success |
23 | data | 正确时：obj<br />错误时：null | 信息本体 | |
24
25 `data`对象：
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 | 投币数 | |
54
55 `data`中的`statistic`对象：
56
57 | 字段 | 类型 | 内容 | 备注 |
58 | ------- | ---- | -------- | ---- |
59 | sid | num | 音频auID | |
60 | play | num | 播放次数 | |
61 | collect | num | 收藏数 | |
62 | comment | num | 评论数 | |
63 | share | num | 分享数 | |
64
65 `data`中的`vipInfo`对象：
66
67 | 字段 | 类型 | 内容 | 备注 |
68 | ------------ | ---- | ------------ | ----------------------------------- |
69 | type | num | 会员类型 | 0：无<br />1：月会员<br />2：年会员 |
70 | status | num | 会员状态 | 0：无<br />1：有 |
71 | due_date | num | 会员到期时间 | 时间戳 毫秒 |
72 | vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
73
74 **示例：**
75
76 查询音频`au13598`的基本信息
77
78 http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
79
80 ```json
81 {
82 "code": 0,
83 "msg": "success",
84 "data": {
85 "id": 13598,
86 "uid": 486183,
87 "uname": "排骨教主",
88 "author": "排骨教主",
89 "title": "牵丝戏",
90 "cover": "http://i0.hdslb.com/bfs/music/cf50d93b4dc08bfc6d3112041d6de0e56045ac5b.jpg",
91 "intro": "自制 这次要特别感谢山东省京剧院的各位年轻的老师们对我戏腔发声的悉心指导\n关注排骨的微博@排骨节操收割机\n排骨QQ群456237456\n感谢@妄北没睡够（新浪微博） 画的视频图，太美了！！！！！\n",
92 "lyric": "http://i0.hdslb.com/bfs/music/150587810313598.lrc",
93 "crtype": 1,
94 "duration": 239,
95 "passtime": 1501640683,
96 "curtime": 1589951574,
97 "aid": 2554020,
98 "bvid": "BV1us411S7E6",
99 "cid": 3990196,
100 "msid": 0,
101 "attr": 0,
102 "limit": 0,
103 "activityId": 0,
104 "limitdesc": "",
105 "ctime": null,
106 "statistic": {
107 "sid": 13598,
108 "play": 1027436,
109 "collect": 30892,
110 "comment": 520,
111 "share": 384
112 },
113 "vipInfo": {
114 "type": 2,
115 "status": 1,
116 "due_date": 1620316800000,
117 "vip_pay_type": 0
118 },
119 "collectIds": [],
120 "coin_num": 1777
121 }
122 }
123 ```
124
125
126
127 ## 查询歌曲TAG
128
129 > http://www.bilibili.com/audio/music-service-c/web/tag/song
130
131 *方式:GET*
132
133 **参数：**
134
135 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
136 | ------ | ---- | -------- | ------ | ---- |
137 | sid | url | 音频auID | 必要 | |
138
139 **json回复：**
140
141 根对象：
142
143 | 字段 | 类型 | 内容 | 备注 |
144 | ---- | ------ | -------- | ------------- |
145 | code | num | 返回值 | 0：成功 |
146 | msg | str | 错误信息 | 默认为success |
147 | data | arrary | TAG列表 | 无为空 |
148
149 `data`数组：
150
151 | 项 | 类型 | 内容 | 备注 |
152 | ---- | ---- | -------- | ---- |
153 | 0 | str | TAG1 | |
154 | n | str | TAG(n+1) | |
155 | …… | str | …… | …… |
156
157 `data`数组中的对象：
158
159 | 字段 | 类型 | 内容 | 备注 |
160 | ------- | ---- | ---------- | ---------------- |
161 | type | str | song | **作用尚不明确** |
162 | subtype | num | ？？？ | **作用尚不明确** |
163 | key | num | TAG ID？？ | **作用尚不明确** |
164 | info | str | TAG名 | |
165
166 **示例：**
167
168 查询音频`au15664`的TAG
169
170 http://www.bilibili.com/audio/music-service-c/web/tag/song?sid=15664
171
172 ```json
173 {
174 "code": 0,
175 "msg": "success",
176 "data": [
177 {
178 "type": "song",
179 "subtype": 0,
180 "key": 1,
181 "info": "音乐"
182 },
183 {
184 "type": "song",
185 "subtype": 1,
186 "key": 3,
187 "info": "人声"
188 },
189 {
190 "type": "song",
191 "subtype": 2,
192 "key": 2,
193 "info": "翻唱"
194 },
195 {
196 "type": "song",
197 "subtype": 3,
198 "key": 33,
199 "info": "日语"
200 },
201 {
202 "type": "song",
203 "subtype": 5,
204 "key": 41,
205 "info": "网络歌曲"
206 },
207 {
208 "type": "song",
209 "subtype": 4,
210 "key": 7,
211 "info": "流行"
212 }
213 ]
214 }
215 ```
216
217
218
219 ## 查询歌曲创作成员列表
220
221 > http://www.bilibili.com/audio/music-service-c/web/member/song
222
223 *方式:GET*
224
225 **参数：**
226
227 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
228 | ------ | ---- | -------- | ------ | ---- |
229 | sid | url | 音频auID | 必要 | |
230
231 **json回复：**
232
233 根对象：
234
235 | 字段 | 类型 | 内容 | 备注 |
236 | ---- | ------ | ------------ | ------------- |
237 | code | num | 返回值 | 0：成功 |
238 | msg | str | 错误信息 | 默认为success |
239 | data | arrary | 成员类型列表 | 无为空 |
240
241 `data`数组：
242
243 | 项 | 类型 | 内容 | 备注 |
244 | ---- | ---- | ------------- | ---- |
245 | 0 | str | 成员类型1 | |
246 | n | str | 成员类型(n+1) | |
247 | …… | str | …… | …… |
248
249 `data`数组中的对象：
250
251 | 字段 | 类型 | 内容 | 备注 |
252 | ---- | ------ | ------------ | ------------------------------------------------------------ |
253 | list | arrary | 成员列表 | |
254 | type | num | 成员类型代码 | 1：歌手<br />2：作词<br />3：作曲<br />4：编曲<br />5：后期/混音<br />7：封面制作<br />8：音源<br />9：调音<br />10：演奏<br />11：乐器<br />127：UP主 |
255
256 `data`数组中的对象中的`list`数组：
257
258 | 项 | 类型 | 内容 | 备注 |
259 | ---- | ---- | --------- | ---- |
260 | 0 | str | 成员1 | |
261 | n | str | 成员(n+1) | |
262 | …… | str | …… | …… |
263
264 `list`数组中的对象：
265
266 | 字段 | 类型 | 内容 | 备注 |
267 | --------- | ---- | ---------- | ---------------- |
268 | mid | num | 0 | **作用尚不明确** |
269 | name | str | 成员名 | |
270 | member_id | num | 成员ID？？ | **作用尚不明确** |
271
272 **示例：**
273
274 查询音频`au815861`的创作成员信息
275
276 http://www.bilibili.com/audio/music-service-c/web/member/song?sid=815861
277
278 ```json
279 {
280 "code": 0,
281 "msg": "success",
282 "data": [
283 {
284 "list": [
285 {
286 "mid": 0,
287 "name": "匀子Cyrena",
288 "member_id": 164341
289 }
290 ],
291 "type": 1
292 },
293 {
294 "list": [
295 {
296 "mid": 0,
297 "name": "圣月樱泪 ",
298 "member_id": 12349
299 }
300 ],
301 "type": 2
302 },
303 {
304 "list": [
305 {
306 "mid": 0,
307 "name": "Days的Wing翼",
308 "member_id": 13777
309 }
310 ],
311 "type": 3
312 },
313 {
314 "list": [
315 {
316 "mid": 0,
317 "name": "Days的Wing翼",
318 "member_id": 13777
319 }
320 ],
321 "type": 4
322 },
323 {
324 "list": [
325 {
326 "mid": 0,
327 "name": "嘟比Dubi",
328 "member_id": 40902
329 }
330 ],
331 "type": 5
332 },
333 {
334 "list": [
335 {
336 "mid": 0,
337 "name": "匀子Cyrena",
338 "member_id": 164222
339 }
340 ],
341 "type": 127
342 }
343 ]
344 }
345 ```
346
347
348
349 ## 获取歌曲歌词
350
351 > http://www.bilibili.com/audio/music-service-c/web/song/lyric
352
353 *方式:GET*
354
355 同「查询歌曲基本信息」中的lrc歌词
356
357 **参数：**
358
359 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
360 | ------ | ---- | -------- | ------ | ---- |
361 | sid | url | 音频auID | 必要 | |
362
363 **json回复：**
364
365 根对象：
366
367 | 字段 | 类型 | 内容 | 备注 |
368 | ---- | ----------------------------- | --------------- | ------------- |
369 | code | num | 返回值 | 0：成功 |
370 | msg | str | 错误信息 | 默认为success |
371 | data | 正确时：str<br />错误时：null | lrc格式歌词信息 | 无为空 |
372
373 **示例：**
374
375 获取音频`au15664`的歌词信息
376
377 http://www.bilibili.com/audio/music-service-c/web/song/lyric?sid=15664
378
379 ```json
380 {
381 "code": 0,
382 "msg": "success",
383 "data": "[ar:萧忆情]\n\n[ti:威风堂堂]\n\n[00:26.64]引诱谁去摘下禁果\n\n[00:28.11]甜美滋味偷咬一口\n\n[00:30.03]触及到了最深处果核\n\n[00:31.82]身体开始颤抖\n\n[00:33.85]舌尖已濡湿双腿内侧\n\n[00:35.55]神经末梢警报响彻\n\n[00:37.39]自内而外逐渐变得火热\n\n[00:39.14]现在无须再遵守规则\n\n[00:42.14]还故作矜持说违心的话\n\n[00:45.84]为何动作不停下\n\n[00:47.85]停下来\n\n[00:48.39]已经快停不下来\n\n[00:49.42]还想索取更多\n\n[00:50.46]踩碎那PRIDE\n\n[00:51.41]忘记毫无意义的理智存在\n\n[00:53.27]让暧昧因子在四处的徘徊\n\n[00:55.19]给我收起你那\n\n[00:56.21]太虚伪的STYLE\n\n[00:57.01]直白赤裸的爱\n\n[00:58.00]最原始的DIVE\n\n[00:58.86]喘息中断续的声音叫期待\n\n[01:00.65]别掩饰此刻\n\n[01:01.50]那让人意乱情迷的SMILE\n\n[01:10.90]缓慢吐息迷惑双眼的雾\n\n[01:12.49]强制禁锢身下轻舔锁骨\n\n[01:14.23]就让封锁的心渐渐领悟\n\n[01:15.97]别继续装无辜\n\n[01:17.54]开始脱下的衬衫\n\n[01:19.08]最后的纽扣解开它\n\n[01:20.98]快感get\n\n[01:21.85]从此不顾一切\n\n[01:23.32]还在犹豫什么\n\n[01:24.78]Darling\n\n[01:26.54]站在自由世界的正中央\n\n[01:30.09]窥探你幻想的是否太过浪荡\n\n[01:33.99]太难耐\n\n[01:34.41]分分秒秒太难耐\n\n[01:35.61]床笫间的狩猎\n\n[01:36.63]充满野心的TRY\n\n[01:37.66]不承认口头上无理的摊牌\n\n[01:39.58]只想要在身体里深埋\n\n[01:41.34]现在由我掌控\n\n[01:42.36]随心所欲的LIFE\n\n[01:43.40]给你要的未来\n\n[01:44.41]永远不腐坏\n\n[01:45.32]所有的阴暗面统统藏起来\n\n[01:46.70]仅为你一人展现那能骄傲夸耀的MIND\n\n[01:49.90]将不安的情绪碾至粉末\n\n[01:53.14]抹在你胸口印上最鲜艳的红\n\n[02:21.06]别打算缩起来置身之外\n\n[02:22.64]无论何时\n\n[02:23.27]NO TIME\n\n[02:23.58]ALL RIGHT\n\n[02:24.21]打破一切的羞耻值\n\n[02:25.43]哪里奇怪\n\n[02:26.06]哪里奇怪\n\n[02:26.68]哪里奇怪\n\n[02:27.30]BURN BURN BURN\n\n[02:28.22]想要的就是那\n\n[02:29.17]啊 没错\n\n[02:29.87]再给我更多的触摸\n\n[02:31.62]顺位交换贴近肌肤的DANCE\n\n[02:33.34]好吧 肆无忌惮\n\n[02:34.98]停下来\n\n[02:35.35]已经快停不下来\n\n[02:36.50]还想索取更多\n\n[02:37.68]踩碎那PRIDE\n\n[02:38.38]忘记毫无意义的理智存在\n\n[02:40.27]让暧昧因子在四处的徘徊\n\n[02:42.11]给我收起你那\n\n[02:43.16]太虚伪的STYLE\n\n[02:44.00]直白赤裸的爱\n\n[02:45.06]最原始的DIVE\n\n[02:45.90]喘息中断续的声音叫期待\n\n[02:47.76]别掩饰此刻那让人意乱情迷的SMILE\n\n[02:50.64]将不安的情绪碾至粉末\n\n[02:54.09]抹在你胸口印上最鲜艳的红\n\n[02:58.35]抛弃所有只想拥有此刻\n\n"
384 }
385 ```
386
Added music/status_number.md +56 -0
@@ -0,0 +1,56 @@
1 # 音频状态数
2
3 ## 歌曲状态数
4
5 >http://www.bilibili.com/audio/music-service-c/web/stat/song
6
7 *方式:GET*
8
9 唯缺投币数2333333
10
11 **参数：**
12
13 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
14 | ------ | ---- | -------- | ------ | ---- |
15 | sid | url | 音频auID | 必要 | |
16
17 **json回复：**
18
19 根对象：
20
21 | 字段 | 类型 | 内容 | 备注 |
22 | ---- | ---- | -------- | ------------------------------- |
23 | code | num | 返回值 | 0：成功<br />72000000：参数错误 |
24 | msg | str | 错误信息 | 默认为success |
25 | data | obj | 信息本体 | |
26
27 `data`对象：
28
29 | 字段 | 类型 | 内容 | 备注 |
30 | ------- | ---- | -------- | ---- |
31 | sid | num | 音频auID | |
32 | play | num | 播放次数 | |
33 | collect | num | 收藏数 | |
34 | comment | num | 评论数 | |
35 | share | num | 分享数 | |
36
37 **示例：**
38
39 查询歌曲`au15664`的状态数
40
41 http://www.bilibili.com/audio/music-service-c/web/stat/song?sid=15664
42
43 ```json
44 {
45 "code": 0,
46 "msg": "success",
47 "data": {
48 "sid": 15664,
49 "play": 1377390,
50 "collect": 44340,
51 "comment": 2756,
52 "share": 4114
53 }
54 }
55 ```
56