github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00
Code Issues Packages Projects Releases Wiki Activity

添加音频收藏夹相关

Browse Source
This commit is contained in:
SocialSisterYi 2020-05-29 10:58:29 +08:00
parent 67a912502c
commit b4b1090401
3 changed files with 314 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
README.md
View File

@ -6,7 +6,7 @@
**不断更新中....**
本项目对B站web端散落在世界各地的野生api进行收集整理，以及研究使用方法并对其进行说明，运用了黑箱法、控制变量法、js逆向分析法等研究办法
本项目对B站web端以及移动端散落在世界各地的野生api进行收集整理，以及研究使用方法并对其进行说明，运用了黑箱法、控制变量法、js逆向分析法等研究办法
所有api均为标准http协议，返回值大都为json
@ -56,10 +56,10 @@
- 文集基本信息
- [音频](music)
- [歌曲基本信息](music/info.md)√
- [歌单&音频收藏夹详细信息](music/music_list.md)×
- [状态数](music/status_number.md)×
- [投币&收藏](music/coin&fav.md)×
- 播放&下载地址（音频流）
- 歌单相关
- 音频榜单
- [排行榜&最新动态](ranking&dynamic)
- [排行榜](ranking&dynamic/ranking.md)x

74
music/info.md
View File

@ -24,33 +24,33 @@
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ------ | ------------ | ---------------- |
| id | num | 音频auID | |
| uid | num | UP主UID | |
| uname | str | UP主昵称 | |
| author | str | 作者名 | |
| title | str | 歌曲标题 | |
| cover | str | 封面图片url | |
| intro | str | 歌曲简介 | |
| lyric | str | lrc歌词url | |
| crtype | num | 1 | **作用尚不明确** |
| duration | num | 歌曲时间长度 | 单位为秒 |
| passtime | num | 歌曲发布时间 | 时间戳 |
| curtime | num | 当前请求时间 | 时间戳 |
| aid | num | 关联视频avID | 无为0 |
| bvid | str | 关联视频bvID | 无为空 |
| cid | num | 关联视频CID | 无为0 |
| msid | num | 0 | **作用尚不明确** |
| attr | num | 0 | **作用尚不明确** |
| limit | num | 0 | **作用尚不明确** |
| activityId | num | 0 | **作用尚不明确** |
| limitdesc | str | 空 | **作用尚不明确** |
| ctime | null | - | **作用尚不明确** |
| statistic | obj | 状态数 | |
| vipInfo | obj | UP主会员状态 | |
| collectIds | arrary | 空 | **作用尚不明确** |
| coin_num | num | 投币数 | |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ------ | ------------------ | ------------------ |
| id | num | 音频auID | |
| uid | num | UP主UID | |
| uname | str | UP主昵称 | |
| author | str | 作者名 | |
| title | str | 歌曲标题 | |
| cover | str | 封面图片url | |
| intro | str | 歌曲简介 | |
| lyric | str | lrc歌词url | |
| crtype | num | 1 | **作用尚不明确** |
| duration | num | 歌曲时间长度 | 单位为秒 |
| passtime | num | 歌曲发布时间 | 时间戳 |
| curtime | num | 当前请求时间 | 时间戳 |
| aid | num | 关联视频avID | 无为0 |
| bvid | str | 关联视频bvID | 无为空 |
| cid | num | 关联视频CID | 无为0 |
| msid | num | 0 | **作用尚不明确** |
| attr | num | 0 | **作用尚不明确** |
| limit | num | 0 | **作用尚不明确** |
| activityId | num | 0 | **作用尚不明确** |
| limitdesc | str | 空 | **作用尚不明确** |
| ctime | null | - | **作用尚不明确** |
| statistic | obj | 状态数 | |
| vipInfo | obj | UP主会员状态 | |
| collectIds | arrary | 歌曲所在的收藏夹ID | 需要登录(SESSDATA) |
| coin_num | num | 投币数 | |
`data`中的`statistic`对象：
@ -71,6 +71,14 @@
| due_date | num | 会员到期时间 | 时间戳 毫秒 |
| vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
`data`中的`collectIds`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------------- | ---- |
| 0 | num | 第1个所在的收藏夹ID | |
| n | num | 第（n+1）个所在的收藏夹ID | |
| …… | num | …… | …… |
**示例：**
查询音频`au13598`的基本信息
@ -93,7 +101,7 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
"crtype": 1,
"duration": 239,
"passtime": 1501640683,
"curtime": 1589951574,
"curtime": 1590154258,
"aid": 2554020,
"bvid": "BV1us411S7E6",
"cid": 3990196,
@ -105,9 +113,9 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
"ctime": null,
"statistic": {
"sid": 13598,
"play": 1027436,
"collect": 30892,
"comment": 520,
"play": 1028516,
"collect": 30914,
"comment": 523,
"share": 384
},
"vipInfo": {
@ -116,7 +124,9 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
"due_date": 1620316800000,
"vip_pay_type": 0
},
"collectIds": [],
"collectIds": [
15967839
],
"coin_num": 1777
}
}

270
music/music_list.md Normal file
View File

@ -0,0 +1,270 @@
# 歌单&音频收藏夹详细信息
## 查询自己创建的歌单
> https://www.bilibili.com/audio/music-service-c/web/collections/list
*方式：GET*
需要登录(SESSDATA)及验证DedeUserID存在且不为0
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| pn | url | 页码 | 必要 | |
| ps | url | 每页项数 | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：未登录 |
| msg | str | 错误信息 | 默认为success |
| data | 正确时：obj<br />错误时：null | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------ | ---- |
| curPage | num | 当前页码 | |
| pageCount | num | 总计页数 | |
| totalSize | num | 总计收藏夹数 | |
| pageSize | num | 当前页面项数 | |
| data | arrary | 歌单列表 | |
`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：普通收藏夹<br />1：默认收藏夹 |
| published | num | 是否公开 | 0：不公开<br />1：公开 |
| cover | str | 歌单封面图片url | |
| ctime | num | 歌单创建时间 | 时间戳 |
| song | num | 歌单中的音乐数量 | |
| desc | str | 歌单备注信息 | |
| sids | arrary | 歌单中的音乐 | |
| 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 | 分享次数 | |
**示例：**
http://www.bilibili.com/audio/music-service-c/web/collections/list?pn=1&ps=2
共计创建了两个歌单，如下
```json
{
"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*
需要登录(SESSDATA)及验证DedeUserID存在且不为0
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------------------ |
| sid | url | 音频收藏夹ID | 必要 | 必须为默认收藏夹ID |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：未登录 |
| msg | str | 错误信息 | 默认为success |
| data | 正确时：obj<br />错误时：null | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------------------ | ---------------------- |
| id | num | 音频收藏夹ID | |
| uid | num | 创建用户UID | |
| uname | str | 创建用户昵称 | |
| title | str | 默认歌单 | 恒为`默认歌单` |
| type | num | 1 | 恒为`1` |
| published | num | 是否公开 | 0：不公开<br />1：公开 |
| cover | str | 歌单封面图片url | |
| ctime | num | 歌单创建时间 | 时间戳 |
| song | num | 歌单中的音乐数量 | |
| desc | str | 空 | 恒为空 |
| sids | arrary | 歌单中的音乐 | |
| 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 `
https://www.bilibili.com/audio/music-service-c/web/collections/info?sid=15967839
```json
{
"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
}
}
}
```