github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-28 05:20:07 +08:00
Code Issues Packages Projects Releases Wiki Activity
c80d0e5f9f
bilibili-API-collect/fav/action.md

483 lines
16 KiB
Markdown
Raw Normal View History

勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
# 收藏夹操作
添加【404页漫画】更新【相关项目】并勘误
2021-07-12 01:28:44 +08:00
- [管理收藏夹](#管理收藏夹)
- [新建收藏夹](#新建收藏夹)
- [修改收藏夹](#修改收藏夹)
- [删除收藏夹](#删除收藏夹)
- [管理收藏内容](#管理收藏内容)
- [批量复制内容](#批量复制内容)
- [清空所有失效内容](#清空所有失效内容)
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
---
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
## 管理收藏夹
### 新建收藏夹
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
> https://api.bilibili.com/x/v3/fav/folder/add
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
*请求方式：POST*
认证方式：APP或Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | -------------- | ------------------------------------ |
| title | str | 收藏夹标题 | 必要 | |
| intro | str | 收藏夹简介 | 非必要 | 默认为空 |
| privacy | num | 是否公开 | 非必要 | 默认为公开<br />0：公开<br />1：私密 |
| cover | str | 封面图url | 非必要 | 封面会被审核 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
添加Java获取dev_id的示例 (#353) * 添加漫画签到接口 * 添加积分商城相关接口 * 添加基本兑换状态码 * fix format * 添加新项 * 链接勘误 * 添加Java获取dev_id的示例 * Revert "添加Java获取dev_id的示例" This reverts commit 125828bb * 添加Java获取dev_id的示例 * 大会员权益信息更新 * 查询自己收到的充电列表 * 更新视频取流相关参数 * 签到请求地址更正 * 添加查询签到状态接口 * 补充用户信息字段 * 补充粉丝勋章信息字段说明 * 添加系统提示类型 * UPDATE * UPDATE * UPDATE * 添加: 查询我收到的充电留言 * 添加: 查询充电留言详情 * 添加: 回复充电留言 * UPDATE * UPDATE Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
2022-05-14 13:40:01 +08:00
| code | num | 返回值 | 0：成功<br />-102：账号被封停 |
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
略....
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
详见[获取收藏夹元数据](info.md#获取收藏夹元数据)中的`data`对象
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
**示例：**
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
创建一个叫`test`,简介是`2333`,封面`https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png`,的公开收藏夹:
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
```shell
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
curl 'https://api.bilibili.com/x/v3/fav/folder/add' \
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
--data-urlencode 'title=test' \
--data-urlencode 'intro=2333' \
--data-urlencode 'privacy=0' \
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
--data-urlencode 'cover=https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
--data-urlencode 'csrf=xxxx' \
-b 'SESSDATA=xxxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"id": 1182306172,
"fid": 11823061,
"mid": 470310172,
"attr": 6,
"title": "test",
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
"cover": "https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
"upper": {
"mid": 0,
"name": "",
"face": "",
"followed": false,
"vip_type": 0,
"vip_statue": 0
},
"cover_type": 0,
"cnt_info": {
"collect": 0,
"play": 0,
"thumb_up": 0,
"share": 0
},
"type": 0,
"intro": "2333",
"ctime": 0,
"mtime": 0,
"state": 0,
"fav_state": 0,
"like_state": 0,
"media_count": 0
}
}
```
</details>
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
### 修改收藏夹
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
> https://api.bilibili.com/x/v3/fav/folder/edit
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
*请求方式：POST*
认证方式：APP或Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | -------------- | ------------------------------------------ |
| media_id | num | 目标收藏夹mdid | 必要 | |
| title | str | 修改收藏夹标题 | 必要 | |
| intro | str | 修改收藏夹简介 | 非必要 | |
| privacy | num | 是否公开 | 非必要 | 默认为公开<br /><br />0：公开<br />1：私密 |
| cover | str | 封面图url | 非必要 | 封面会被审核 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
添加Java获取dev_id的示例 (#353) * 添加漫画签到接口 * 添加积分商城相关接口 * 添加基本兑换状态码 * fix format * 添加新项 * 链接勘误 * 添加Java获取dev_id的示例 * Revert "添加Java获取dev_id的示例" This reverts commit 125828bb * 添加Java获取dev_id的示例 * 大会员权益信息更新 * 查询自己收到的充电列表 * 更新视频取流相关参数 * 签到请求地址更正 * 添加查询签到状态接口 * 补充用户信息字段 * 补充粉丝勋章信息字段说明 * 添加系统提示类型 * UPDATE * UPDATE * UPDATE * 添加: 查询我收到的充电留言 * 添加: 查询充电留言详情 * 添加: 回复充电留言 * UPDATE * UPDATE Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
2022-05-14 13:40:01 +08:00
| code | num | 返回值 | 0：成功<br />-102：账号被封停 |
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
略....
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
详见[获取收藏夹元数据](info.md#获取收藏夹元数据)中的`data`对象
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
**示例：**
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
修改id为`1182306172`的名字为`test`,简介为`2333`,封面为`https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png`,公开收藏夹:
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
```shell
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
curl 'https://api.bilibili.com/x/v3/fav/folder/edit' \
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
--data-urlencode 'media_id=1182306172' \
--data-urlencode 'title=test' \
--data-urlencode 'intro=2333' \
--data-urlencode 'privacy=0' \
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
--data-urlencode 'cover=https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
--data-urlencode 'csrf=xxxx' \
-b 'SESSDATA=xxxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"id": 1182306172,
"fid": 11823061,
"mid": 470310172,
"attr": 6,
"title": "test",
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
"cover": "https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
"upper": {
"mid": 0,
"name": "",
"face": "",
"followed": false,
"vip_type": 0,
"vip_statue": 0
},
"cover_type": 0,
"cnt_info": {
"collect": 0,
"play": 0,
"thumb_up": 0,
"share": 0
},
"type": 0,
"intro": "2333",
"ctime": 0,
"mtime": 0,
"state": 0,
"fav_state": 0,
"like_state": 0,
"media_count": 0
}
}
```
</details>
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
### 删除收藏夹
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
> https://api.bilibili.com/x/v3/fav/folder/del
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
*请求方式：POST*
认证方式：APP或Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | ------------------------ | -------------- | ------------------- |
| media_ids | nums | 目标收藏夹mdid列表 | 必要 | 每个成员间用`,`分隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 成功为0 |
| ttl | num | 1 | |
| data | num | 信息本体 | 成功为0 |
**示例：**
删除id为`1182306172`的收藏夹:
```shell
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
curl 'https://api.bilibili.com/x/v3/fav/folder/del' \
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
--data-urlencode 'media_ids=1182306172' \
--data-urlencode 'csrf=xxxx' \
-b 'SESSDATA=xxxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":0
}
```
</details>
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
## 管理收藏内容
### 批量复制内容
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
> https://api.bilibili.com/x/v3/fav/resource/copy
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
*请求方式：POST*
认证方式：APP或Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| src_media_id | num | 源收藏夹id | 必要 | |
| tar_media_id | num | 目标收藏夹id | 必要 | |
| mid | num | 当前用户mid | 必要 | |
| resources | strs | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />21：视频合集<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
| platform | str | 平台标识 | 非必要 | 可为web |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />11010：您访问的内容不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 成功为0 |
**示例：**
将id为`1288061499`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`复制到id为`1178751999`的收藏夹中
```shell
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
curl 'https://api.bilibili.com/x/v3/fav/resource/copy' \
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
--data-urlencode 'src_media_id=1288061499' \
--data-urlencode 'tar_media_id=1178751999' \
--data-urlencode 'mid=233333' \
--data-urlencode 'resources=21822819:2,21918689:2,22288065:2' \
--data-urlencode 'platform=web' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":0
}
```
</details>
### 批量移动内容
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
> https://api.bilibili.com/x/v3/fav/resource/move
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
*请求方式：POST*
认证方式：APP或Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| src_media_id | num | 源收藏夹id | 必要 | |
| tar_media_id | num | 目标收藏夹id | 必要 | |
| mid | num | 当前用户mid | 必要 | |
| resources | strs | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />21：视频合集<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
| platform | str | 平台标识 | 非必要 | 可为web |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />11010：您访问的内容不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 成功为0 |
**示例：**
将id为`1288061499`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`移动到id为`1178751999`的收藏夹中
```shell
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
curl 'https://api.bilibili.com/x/v3/fav/resource/move' \
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
--data-urlencode 'src_media_id=1288061499' \
--data-urlencode 'tar_media_id=1178751999' \
--data-urlencode 'mid=233333' \
--data-urlencode 'resources=21822819:2,21918689:2,22288065:2' \
--data-urlencode 'platform=web' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":0
}
```
</details>
### 批量删除内容
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
> https://api.bilibili.com/x/v3/fav/resource/batch-del
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
*请求方式：POST*
认证方式：APP或Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | -------------- | ------------------------ | ------------------------------------------------------------ | ------- |
| resources | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />21：视频合集<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id | |
| media_id | num | 目标收藏夹id | 必要 | |
| platform | str | 平台标识 | 非必要 | 可为web |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />11010：您访问的内容不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 成功为0 |
**示例：**
将id为`1178751999`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`取消收藏
```shell
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
curl 'https://api.bilibili.com/x/v3/fav/resource/batch-del' \
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
--data-urlencode 'resources=21822819:2,21918689:2,22288065:2' \
--data-urlencode 'media_id=1178751999' \
--data-urlencode 'platform=web' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":0
}
```
</details>
### 清空所有失效内容
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
> https://api.bilibili.com/x/v3/fav/resource/clean
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
*请求方式：POST*
认证方式：APP或Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | -------------- | ---- |
| media_id | num | 目标收藏夹id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 成功为0 |
**示例：**
清理id为`1161340172`的收藏夹
```shell
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00
curl 'https://api.bilibili.com/x/v3/fav/resource/clean' \
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
--data-urlencode 'media_id=1161340172' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
添加【收藏夹批量操作】相关api
2021-07-12 00:27:56 +08:00
勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:32:01 +08:00
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":0
}
```
删除错误说明 (#284) 勘误，应该是别人复制改完了没发现qwq
2021-12-10 17:58:41 +08:00
</details>
Reference in New Issue Copy Permalink