diff --git a/README.md b/README.md index 7a5e906..2d0aa83 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/music/info.md b/music/info.md index 0ee7275..ea61793 100644 --- a/music/info.md +++ b/music/info.md @@ -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：无
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 } } diff --git a/music/music_list.md b/music/music_list.md new file mode 100644 index 0000000..5eb0b3b --- /dev/null +++ b/music/music_list.md @@ -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：成功
72000000：参数错误
72010002：未登录 | +| msg | str | 错误信息 | 默认为success | +| data | 正确时：obj
错误时：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：普通收藏夹
1：默认收藏夹 | +| published | num | 是否公开 | 0：不公开
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：成功
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 | 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 + } + } +} +``` + + +