github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-01-01 15:30:08 +08:00
Code Issues Packages Projects Releases Wiki Activity
bb437d2012
bilibili-API-collect/audio/music_list.md

301 lines
11 KiB
Markdown
Raw Normal View History

添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
# 歌单&音频收藏夹详细信息
https统一写作http (#288) * https统一写作http * 勘误
2021-12-17 10:26:13 +08:00
- [歌单&音频收藏夹详细信息](#歌单音频收藏夹详细信息)
- [查询自己创建的歌单](#查询自己创建的歌单)
- [查询音频收藏夹（默认歌单）信息](#查询音频收藏夹默认歌单信息)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
https统一写作http (#288) * https统一写作http * 勘误
2021-12-17 10:26:13 +08:00
- [歌单&音频收藏夹详细信息](#歌单音频收藏夹详细信息)
- [查询自己创建的歌单](#查询自己创建的歌单)
- [查询音频收藏夹（默认歌单）信息](#查询音频收藏夹默认歌单信息)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
---
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
## 查询自己创建的歌单
修改并补完音频流url 并勘误
2020-07-21 17:38:44 +08:00
> http://www.bilibili.com/audio/music-service-c/web/collections/list
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
继续修改文档格式 补完频道相关接口
2020-07-19 21:56:58 +08:00
认证方式：Cookie（SESSDATA）
鉴权方式：Cookie中`DedeUserID`存在且不为0
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
优化文档格式
2020-06-08 22:44:46 +08:00
**url参数：**
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
优化文档格式
2020-06-08 22:44:46 +08:00
| pn | num | 页码 | 必要 | |
| ps | num | 每页项数 | 必要 | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：未登录 |
| msg | str | 错误信息 | 默认为success |
| data | 正确时：obj<br />错误时：null | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------ | ---- |
| curPage | num | 当前页码 | |
| pageCount | num | 总计页数 | |
| totalSize | num | 总计收藏夹数 | |
| pageSize | num | 当前页面项数 | |
添加评论区明细以及用户最近的游戏
2020-06-12 14:10:21 +08:00
| data | array | 歌单列表 | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
`data`中的`data`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| 0 | obj | 音频收藏夹mlid1 | |
| n | obj | 音频收藏夹mlid(n+1) | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| …… | obj | …… | …… |
`data`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------------------ | -------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| id | num | 音频收藏夹mlid | |
| uid | num | 创建用户mid | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| uname | str | 创建用户昵称 | |
| title | str | 歌单标题 | |
| type | num | 收藏夹属性 | 0：普通收藏夹<br />1：默认收藏夹 |
| published | num | 是否公开 | 0：不公开<br />1：公开 |
| cover | str | 歌单封面图片url | |
| ctime | num | 歌单创建时间 | 时间戳 |
| song | num | 歌单中的音乐数量 | |
| desc | str | 歌单备注信息 | |
添加评论区明细以及用户最近的游戏
2020-06-12 14:10:21 +08:00
| sids | array | 歌单中的音乐 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| menuId | num | 音频收藏夹对应的歌单amid | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| statistic | obj | 歌单状态数信息 | |
`data`中的`sids`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| 0 | num | 收藏的音频auid1 | |
| n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| …… | num | …… | …… |
`data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------------------ | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| sid | num | 音频收藏夹对应的歌单amid | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| play | num | 播放次数 | |
| collect | num | 点赞次数 | |
| comment | null | - | |
| share | num | 分享次数 | |
**示例：**
继续修改文档格式 补完频道相关接口
2020-07-19 21:56:58 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
继续修改文档格式 补完频道相关接口
2020-07-19 21:56:58 +08:00
-b 'SESSDATA=xxx;DedeUserID=1;'
```
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
共计创建了两个歌单，如下
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
```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
}
}
]
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
## 查询音频收藏夹（默认歌单）信息
https统一写作http (#288) * https统一写作http * 勘误
2021-12-17 10:26:13 +08:00
> http://www.bilibili.com/audio/music-service-c/web/collections/info
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
继续修改文档格式 补完频道相关接口
2020-07-19 21:56:58 +08:00
认证方式：Cookie（SESSDATA）
鉴权方式：Cookie中`DedeUserID`存在且不为0
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
优化文档格式
2020-06-08 22:44:46 +08:00
**url参数：**
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------------------ |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| sid | num | 音频收藏夹mlid | 必要 | 必须为默认收藏夹mlid |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />72000000：参数错误<br />72010002：未登录 |
| msg | str | 错误信息 | 默认为success |
| data | 正确时：obj<br />错误时：null | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------------------ | ---------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| id | num | 音频收藏夹mlid | |
| uid | num | 创建用户mid | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| uname | str | 创建用户昵称 | |
| title | str | 默认歌单 | 恒为`默认歌单` |
| type | num | 1 | 恒为`1` |
| published | num | 是否公开 | 0：不公开<br />1：公开 |
| cover | str | 歌单封面图片url | |
| ctime | num | 歌单创建时间 | 时间戳 |
| song | num | 歌单中的音乐数量 | |
| desc | str | 空 | 恒为空 |
添加评论区明细以及用户最近的游戏
2020-06-12 14:10:21 +08:00
| sids | array | 歌单中的音乐 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| menuId | num | 音频收藏夹对应的歌单amid | 与普通歌单不同通用 |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| statistic | obj | 歌单状态数信息 | |
`data`中的`sids`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| 0 | num | 收藏的音频auid1 | |
| n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| …… | num | …… | …… |
`data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------------------ | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| sid | num | 音频收藏夹对应的歌单amid | |
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
| play | num | 0 | |
| collect | num | 0 | |
| comment | null | - | |
| share | num | 0 | |
**示例：**
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
查询我的默认歌单，id为` 15967839 `
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
继续修改文档格式 补完频道相关接口
2020-07-19 21:56:58 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/info' \
--data-urlencode 'sid=15967839 ' \
继续修改文档格式 补完频道相关接口
2020-07-19 21:56:58 +08:00
-b 'SESSDATA=xxx;DedeUserID=1;'
```
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
```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
}
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加音频收藏夹相关
2020-05-29 10:58:29 +08:00
Reference in New Issue Copy Permalink