Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 各种接口补充与错误修正 (#1066)

Browse Source 
* fix(video/collection.md): unclosed xml tags

* feat(video/report.md): uuid not really random

* feat: b23.tv short link

* feat: login/moral/exp log

* feat: v_voucher

* feat: upload video cover & post

* feat(creativecenter/upload.md): upload octet-stream

* feat(creativecenter/upload.md): update some notes

* feat(clientinfo/ip.md): another from live

* feat: live web heartbeat

* feat: update popular series & precious

* fix(creativecenter/upload.md): mistakes in example

* feat: merge duplicate fav info

* feat(README.md): missing link to webmask

* feat(search/hot.md): word_type

* feat(login/login_action): recovery old api

* feat(video/collection.md):  series operation

* feat: video season operation

* feat: add & mod some links

* feat(search/suggest.md): up to date

* feat: web home header image

* feat(misc/sign/bili_ticket.md): demo for nodejs

* feat(creativecenter/upload.md): x-upos-auth validity period

* feat: add referer & buvid3 to request header

* feat: customer service message heartbeat & upload

* feat(customerservice/msg.md): upload code 1200201

* feat(video/report.md): click/web/h5

* feat(video/report.md): view count desc

* feat: laser2

* feat: wbi_key in bili_ticket

* fix: typo & unclosed XML tags

* feat(misc/sign/v_voucher): cookie x-bili-gaia-vtoken

* feat(search/hot.md): square

* feat(video/status_number.md): fold archive_stat/stat

* feat(fav/info.md): resource/infos invalid type 21

* feat: /x/activity/subject/info

* feat: lottery

* feat(docs/misc/b23.tv): remove some unnecessary fields

* feat(creativecenter/upload.md): types/predict

* fix(video/collection.md): invalid end tag

* feat: app version upgrade

* feat(creativecenter/upload.md): tag/recommend #528

* feat(user/status_number.md): navnum

* feat: /x/activity/page/list

* feat(comment/list.md): desc about pagination_str

* feat(comment/list.md): update example

* feat(dynamic/all.md): #1082

* fix(comment/list.md): -352 not -412

* feat: #700

* feat(video/video_stream.md): #606 & cv949156

* feat(message/private_msg.md): single_unread freq

* feat: getUserWallet

* fix: broken form

* feat(Layout.vue): copyright to 2024

* feat: /x/topic/pub/rcmd/search

* feat: #425

* feat(misc/time_stamp.md): rtc/getTimestamp

* fix(misc/time_stamp.md): missing end tag

* feat: #745

* feat(dynamic/all.md): update feed/all

* feat(danmaku/action.md): #220

* feat(live/info.md): gethistory from cv8186413

* fix(danmaku/action.md): missing end tag
This commit is contained in:
Session小胡
2024-08-21 19:02:39 +08:00
committed by GitHub
parent f7599fb693
commit 60a0c5d1a2
46 changed files with 18489 additions and 8207 deletions
Download Patch File Download Diff File Expand all files Collapse all files

459
docs/fav/info.md
View File

@@ -1,12 +1,14 @@
# 收藏夹基本信息
<img src="../../assets/img/collect.svg" width="100" height="100" />
## 获取收藏夹元数据
> https://api.bilibili.com/x/v3/fav/folder/info
*请求方式：GET*
认证方式：Cookie或APP
认证方式：Cookie(SESSDATA) 或 APP
**注：查询权限收藏夹时需要相应用户登录**
@@ -48,7 +50,6 @@
| like_state | num | 点赞状态 | 已点赞：1<br />未点赞：0<br />需要登录 |
| media_count | num | 收藏夹内容数量 | |
`data`中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
@@ -125,21 +126,19 @@ curl -G 'https://api.bilibili.com/x/v3/fav/folder/info' \
## 获取指定用户创建的所有收藏夹信息
> https://api.bilibili.com/x/v3/fav/folder/created/list-all
> https://api.bilibili.com/x/v3/fav/folder/created/list-all
*请求方式：GET*
认证方式：Cookie或APP
认证方式：Cookie (SESSDATA) 或 APP
**注：查询权限收藏夹时需要相应用户登录**
该接口也能查询目标内容id存在于那些收藏夹中
若欲查看相应用户的私密收藏夹需要登录
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ---------------------------------------- |
| up_mid | num | 目标用户mid | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| up_mid | num | 目标用户mid | 必要 | |
| type | num | 目标内容属性 | 非必要 | 默认为全部<br />0：全部<br />2：视频稿件 |
| rid | num | 目标内容id | 非必要 | 视频稿件：视频稿件avid |
@@ -151,43 +150,52 @@ curl -G 'https://api.bilibili.com/x/v3/fav/folder/info' \
| ------- | ----------------------------- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| data | 有效时：obj<br />无效或：null | 信息本体 | |
| ttl | num | 1 | |
| data | 隐藏时：null<br />公开时：obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ----- | ---------------- | ---- |
| count | num | 创建的收藏夹总数 | |
| list | array | 创建的收藏夹列表 | |
| 字段 | 类型 | 内容 | 备注 |
| ----- | --------------------------------------- | -------------- | ---- |
| count | num | 创建的收藏夹数 | |
| list | 无收藏夹时：null<br />有收藏夹时：array | 收藏夹列表 | |
| season | null | （？） | |
`list`数组：
`data`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---- |
| 0 | obj | 收藏夹1 | |
| n | obj | 收藏夹（n+1） | |
| ... | obj | ... | |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 收藏夹1 | |
| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
| …… | obj | …… | |
`medias`数组中的对象：
`data`中的`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------------ | ------------------------------------------ |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | |
| mid | num | 创建者mid | |
| attr | num | 属性位（？） | |
| attr | num | 属性位 | |
| title | str | 收藏夹标题 | |
| fav_state | num | 目标id是否存在于该收藏夹 | 存在于该收藏夹：1<br />不存在于该收藏夹：0 |
| media_count | num | 收藏夹内容数量 | |
`attr`属性位二进制值表：
| 位 | 内容 | 备注 |
| --------------- | ---------------- | -------------------------------- |
| 0 | 是否为默认收藏夹 | 0：默认收藏夹<br />1：其他收藏夹 |
| 1 | 私有收藏夹 | 0：公开<br />1：私有 |
| 其他有待补充... | | |
**示例：**
查询用户`mid=509372`的所有创建收藏夹列表
查询用户`mid=7792521`的收藏夹列表
```shell
curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \
--data-urlencode 'up_mid=509372' \
--data-urlencode 'up_mid=7792521' \
-b 'SESSDATA=xxx'
```
@@ -196,33 +204,194 @@ curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 2,
"list": [
{
"id": 939227072,
"fid": 9392270,
"mid": 509372,
"attr": 54,
"title": "学习",
"fav_state": 0,
"media_count": 22
},
{
"id": 75020272,
"fid": 750202,
"mid": 509372,
"attr": 22,
"title": "MAD/AMV",
"fav_state": 0,
"media_count": 16
}
],
"season": null
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 5,
"list": [{
"id": 44233921,
"fid": 442339,
"mid": 7792521,
"attr": 0,
"title": "默认收藏夹",
"fav_state": 0,
"media_count": 85
}, {
"id": 936347621,
"fid": 9363476,
"mid": 7792521,
"attr": 22,
"title": "放假君的鬼畜私房歌",
"fav_state": 0,
"media_count": 2
}, {
"id": 845218621,
"fid": 8452186,
"mid": 7792521,
"attr": 22,
"title": "♪一言不合就开唱♪",
"fav_state": 0,
"media_count": 4
}, {
"id": 844998121,
"fid": 8449981,
"mid": 7792521,
"attr": 22,
"title": "个人作品精选",
"fav_state": 0,
"media_count": 25
}, {
"id": 381779121,
"fid": 3817791,
"mid": 7792521,
"attr": 22,
"title": "鬼畜小课堂",
"fav_state": 0,
"media_count": 25
}]
}
}
```
</details>
## 查询用户收藏的视频收藏夹
> https://api.bilibili.com/x/v3/fav/folder/collected/list
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| ps | num | 每页项数 | 必要 | 定义域 1 - 大于70 |
| pn | num | 页码 | 必要 | |
| up_mid | num | 目标用户mid | 必要 | |
| platform | str | 平台类型 | 非必要 | 填写web 返回值才会包含用户收藏的视频合集 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />40022：签名过长 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 隐藏时：null<br />公开时：obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | --------------------------------------- | -------------- | ---- |
| count | num | 创建的收藏夹数 | |
| list | 无收藏夹时：null<br />有收藏夹时：array | 收藏夹列表 | |
`data`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 收藏夹1 | |
| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
| …… | obj | …… | |
`data`中的`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------ | ----------------------------------------- |
| id | num | 收藏夹ml | |
| fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户mid | |
| attr | num | 收藏夹属性 | 转换成8-bit二进制处理<br />详细说明见下表 |
| title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | |
| upper | obj | 收藏夹创建用户信息 | |
| cover_type | num | 2 | 作用尚不明确 |
| intro | str | 空 | 作用尚不明确 |
| ctime | num | 创建时间 | 时间戳 |
| mtime | num | 审核时间 | 时间戳 |
| state | num | 0, 1 | 0: 正常；1:收藏夹已失效 |
| fav_state | num | 0 | 作用尚不明确 |
| media_count | num | 收藏夹总计视频数 | |
`attr`属性二进制值表：
| 其他有待补充... | 1：默认收藏夹 | 0：公开性 |
| --------------- | -------------------------------- | -------------------- |
| | 0：默认收藏夹<br />1：其他收藏夹 | 0：公开<br />1：私有 |
`data`中的`list`数组中的对象中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---------- | ------------ |
| mid | num | 创建人mid | |
| name | str | 创建人昵称 | |
| face | str | 空 | 作用尚不明确 |
**示例：**
查询用户`mid=293793435`的收藏夹收藏列表
```shell
curl -G 'https://api.bilibili.com/x/v3/fav/folder/collected/list' \
--data-urlencode 'up_mid=293793435' \
--data-urlencode 'ps=20' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 2,
"list": [{
"id": 496307088,
"fid": 4963070,
"mid": 412466388,
"attr": 22,
"title": "入站必刷",
"cover": "http://i0.hdslb.com/bfs/archive/baae2b4050363c0ab45465b7cf696b8304fdaca8.jpg",
"upper": {
"mid": 412466388,
"name": "热门菌",
"face": ""
},
"cover_type": 2,
"intro": "",
"ctime": 1563394571,
"mtime": 1563394571,
"state": 0,
"fav_state": 0,
"media_count": 55
}, {
"id": 381779121,
"fid": 3817791,
"mid": 7792521,
"attr": 22,
"title": "鬼畜小课堂",
"cover": "http://i2.hdslb.com/bfs/archive/09a668cfdb38fb3a85f905c10f48a2947e36a695.jpg",
"upper": {
"mid": 7792521,
"name": "还有一天就放假了",
"face": ""
},
"cover_type": 2,
"intro": "",
"ctime": 1553700224,
"mtime": 1557291666,
"state": 0,
"fav_state": 0,
"media_count": 25
}]
}
}
```
@@ -238,7 +407,7 @@ curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------------- | ------ | ------------------------------------------------------------ |
| resources | strs | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />21：视频合集<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
| resources | strs | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid |
| platform | str | 平台标识 | 非必要 | 可为web（影响内容列表类型） |
**json回复：**
@@ -263,8 +432,8 @@ curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------- | ------------------------------------------------------------ |
| id | num | 内容id | 视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
| type | num | 内容类型 | 2：视频稿件<br />12：音频<br />21：视频合集 |
| id | num | 内容id | 视频稿件：视频稿件avid<br />音频：音频auid |
| type | num | 内容类型 | 2：视频稿件<br />12：音频 |
| title | str | 标题 | |
| cover | str | 封面url | |
| intro | str | 简介 | |
@@ -303,13 +472,11 @@ curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \
1-视频稿件-`av583785685`
2-视频合集-`523`
3-音频-`au15664`
2-音频-`au15664`
```shell
curl -G 'https://api.bilibili.com/x/v3/fav/resource/infos' \
--data-urlencode 'resources=583785685:2,523:21,15664:12'
--data-urlencode 'resources=583785685:2,15664:12'
```
<details>
@@ -317,93 +484,93 @@ curl -G 'https://api.bilibili.com/x/v3/fav/resource/infos' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [
{
"id": 583785685,
"type": 2,
"title": "已失效视频",
"cover": "http://i0.hdslb.com/bfs/archive/be27fd62c99036dce67efface486fb0a88ffed06.jpg",
"intro": "审核君辛苦了~\r\n使用curl命令访问B站api，实现二维码登录 查询登录信息 视频投币 发送评论的操作\r\n本视频作为api收集项目的一个硬核DEMO\r\n由于当时录音的问题，大部分是后期配的，后面声音有点小\r\n想了解更多的去github页面，也可以qq\r\n\r\nbgm：\r\n雲流れ\r\nAutumn rain（未修改版）\r\n四月，初雨微凉",
"page": 1,
"duration": 604,
"upper": {
"mid": 293793435,
"name": "社会易姐QwQ",
"face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"
},
"attr": 1,
"cnt_info": {
"collect": 1470,
"play": 28374,
"danmaku": 64
},
"link": "bilibili://video/583785685",
"ctime": 1594049831,
"pubtime": 1594049831,
"fav_time": 0,
"bv_id": "BV1kz4y1X7XP",
"bvid": "BV1kz4y1X7XP",
"season": null
},
{
"id": 523,
"type": 21,
"title": "2021哔哩哔哩拜年纪",
"cover": "https://i0.hdslb.com/bfs/archive/8ccc50f7cbc671762e0536491bd2b8aeebc0837d.jpg",
"intro": "感谢各位制作者们的辛勤付出！节目精彩，愿大家看的开心！",
"page": 0,
"duration": 0,
"upper": {
"mid": 1868902080,
"name": "哔哩哔哩拜年纪",
"face": "http://i0.hdslb.com/bfs/face/7f6cb94fc071aca9fbb4b1ca9cc6415e86847576.jpg"
},
"attr": 0,
"cnt_info": {
"collect": 0,
"play": 71527018,
"danmaku": 480547
},
"link": "bilibili://video/373561162",
"ctime": 0,
"pubtime": 0,
"fav_time": 0,
"bv_id": "",
"bvid": "",
"season": null
},
{
"id": 15664,
"type": 12,
"title": "威风堂堂",
"cover": "http://i0.hdslb.com/bfs/music/c417d30b394a8a5d4e8a150ad75837dbae3b79d4.jpg",
"intro": "翻唱。在电脑里放了半个月终于！！！大家寒假快乐！！❁本家sm19233263；❁压制: 寒雨；❁mix: 三星堆；❁vocal: 茶理理。超喜欢michan的那段英文念白所以加了进来w 谢谢三月月和嘟比比你们后期辛苦了！",
"page": 1,
"duration": 200,
"upper": {
"mid": 684169,
"name": "茶理理理子",
"face": ""
},
"attr": 0,
"cnt_info": {
"collect": 48872,
"play": 1508426,
"danmaku": 0
},
"link": "bilibili://music/detail/15664?name=%E5%A8%81%E9%A3%8E%E5%A0%82%E5%A0%82&uperName=%E8%8C%B6%E7%90%86%E7%90%86%E7%90%86%E5%AD%90&cover_url=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Fmusic%2Fc417d30b394a8a5d4e8a150ad75837dbae3b79d4.jpg&upperId=684169&author=%E8%8C%B6%E7%90%86%E7%90%86",
"ctime": 1502347604,
"pubtime": 1502347604,
"fav_time": 0,
"bv_id": "BV1bx411c7qt",
"bvid": "BV1bx411c7qt",
"season": null
}
]
"code": 0,
"message": "0",
"ttl": 1,
"data": [
{
"id": 583785685,
"type": 2,
"title": "已失效视频",
"cover": "http://i0.hdslb.com/bfs/archive/be27fd62c99036dce67efface486fb0a88ffed06.jpg",
"intro": "审核君辛苦了~\r\n使用curl命令访问B站api，实现二维码登录 查询登录信息 视频投币 发送评论的操作\r\n本视频作为api收集项目的一个硬核DEMO\r\n由于当时录音的问题，大部分是后期配的，后面声音有点小\r\n想了解更多的去github页面，也可以qq\r\n\r\nbgm：\r\n雲流れ\r\nAutumn rain（未修改版）\r\n四月，初雨微凉",
"page": 1,
"duration": 604,
"upper": {
"mid": 293793435,
"name": "社会易姐QwQ",
"face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"
},
"attr": 1,
"cnt_info": {
"collect": 1470,
"play": 28374,
"danmaku": 64
},
"link": "bilibili://video/583785685",
"ctime": 1594049831,
"pubtime": 1594049831,
"fav_time": 0,
"bv_id": "BV1kz4y1X7XP",
"bvid": "BV1kz4y1X7XP",
"season": null
},
{
"id": 523,
"type": 21,
"title": "2021哔哩哔哩拜年纪",
"cover": "https://i0.hdslb.com/bfs/archive/8ccc50f7cbc671762e0536491bd2b8aeebc0837d.jpg",
"intro": "感谢各位制作者们的辛勤付出！节目精彩，愿大家看的开心！",
"page": 0,
"duration": 0,
"upper": {
"mid": 1868902080,
"name": "哔哩哔哩拜年纪",
"face": "http://i0.hdslb.com/bfs/face/7f6cb94fc071aca9fbb4b1ca9cc6415e86847576.jpg"
},
"attr": 0,
"cnt_info": {
"collect": 0,
"play": 71527018,
"danmaku": 480547
},
"link": "bilibili://video/373561162",
"ctime": 0,
"pubtime": 0,
"fav_time": 0,
"bv_id": "",
"bvid": "",
"season": null
},
{
"id": 15664,
"type": 12,
"title": "威风堂堂",
"cover": "http://i0.hdslb.com/bfs/music/c417d30b394a8a5d4e8a150ad75837dbae3b79d4.jpg",
"intro": "翻唱。在电脑里放了半个月终于！！！大家寒假快乐！！❁本家sm19233263；❁压制: 寒雨；❁mix: 三星堆；❁vocal: 茶理理。超喜欢michan的那段英文念白所以加了进来w 谢谢三月月和嘟比比你们后期辛苦了！",
"page": 1,
"duration": 200,
"upper": {
"mid": 684169,
"name": "茶理理理子",
"face": ""
},
"attr": 0,
"cnt_info": {
"collect": 48872,
"play": 1508426,
"danmaku": 0
},
"link": "bilibili://music/detail/15664?name=%E5%A8%81%E9%A3%8E%E5%A0%82%E5%A0%82&uperName=%E8%8C%B6%E7%90%86%E7%90%86%E7%90%86%E5%AD%90&cover_url=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Fmusic%2Fc417d30b394a8a5d4e8a150ad75837dbae3b79d4.jpg&upperId=684169&author=%E8%8C%B6%E7%90%86%E7%90%86",
"ctime": 1502347604,
"pubtime": 1502347604,
"fav_time": 0,
"bv_id": "BV1bx411c7qt",
"bvid": "BV1bx411c7qt",
"season": null
}
]
}
```
</details>
</details>