diff --git a/fav/action.md b/fav/action.md index 7f1b9dd..b70195b 100644 --- a/fav/action.md +++ b/fav/action.md @@ -1,14 +1,19 @@ # 收藏夹操作 - [收藏夹操作](#收藏夹操作) - - [新建收藏夹](#新建收藏夹) - - [修改收藏夹](#修改收藏夹) - - [删除收藏夹](#删除收藏夹) - - [清空所有失效内容](#清空所有失效内容) + - [管理收藏夹](#管理收藏夹) + - [新建收藏夹](#新建收藏夹) + - [修改收藏夹](#修改收藏夹) + - [删除收藏夹](#删除收藏夹) + - [管理收藏内容](#管理收藏内容) + - [批量复制内容](#批量复制内容) + - [清空所有失效内容](#清空所有失效内容) --- -## 新建收藏夹 +## 管理收藏夹 + +### 新建收藏夹 > http://api.bilibili.com/x/v3/fav/folder/add @@ -41,7 +46,7 @@ 略.... -详见【[获取收藏夹元数据](info.md#获取收藏夹元数据)】中的`data`对象 +详见[获取收藏夹元数据](info.md#获取收藏夹元数据)中的`data`对象 **示例：** @@ -101,7 +106,7 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/add' \ -## 修改收藏夹 +### 修改收藏夹 > http://api.bilibili.com/x/v3/fav/folder/edit @@ -135,7 +140,7 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/add' \ 略.... -详见【[获取收藏夹元数据](info.md#获取收藏夹元数据)】中的`data`对象 +详见[获取收藏夹元数据](info.md#获取收藏夹元数据)中的`data`对象 **示例：** @@ -196,7 +201,7 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/edit' \ -## 删除收藏夹 +### 删除收藏夹 > http://api.bilibili.com/x/v3/fav/folder/del @@ -247,7 +252,189 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/del' \ -## 清空所有失效内容 +## 管理收藏内容 + +### 批量复制内容 + +> http://api.bilibili.com/x/v3/fav/resource/copy + +*请求方式：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}:{内容类型}
每个成员间用`,`分隔
类型：
2：视频稿件
12：音频
21：视频合集
内容id：
视频稿件：视频稿件avid
音频：音频auid
视频合集：视频合集id | +| platform | str | 平台标识 | 非必要 | 可为web | +| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
11010：您访问的内容不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | 成功为0 | + +**示例：** + +将id为`1288061499`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`复制到id为`1178751999`的收藏夹中 + +清理id为`1161340172`的收藏夹 + +```shell +curl 'http://api.bilibili.com/x/v3/fav/resource/copy' \ +--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' +``` + +
+查看响应示例： + + +```json +{ + "code":0, + "message":"0", + "ttl":1, + "data":0 +} +``` + +
+ +### 批量移动内容 + +> http://api.bilibili.com/x/v3/fav/resource/move + +*请求方式：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}:{内容类型}
每个成员间用`,`分隔
类型：
2：视频稿件
12：音频
21：视频合集
内容id：
视频稿件：视频稿件avid
音频：音频auid
视频合集：视频合集id | +| platform | str | 平台标识 | 非必要 | 可为web | +| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
11010：您访问的内容不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | 成功为0 | + +**示例：** + +将id为`1288061499`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`移动到id为`1178751999`的收藏夹中 + +清理id为`1161340172`的收藏夹 + +```shell +curl 'http://api.bilibili.com/x/v3/fav/resource/move' \ +--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' +``` + +
+查看响应示例： + + +```json +{ + "code":0, + "message":"0", + "ttl":1, + "data":0 +} +``` + +
+ +### 批量删除内容 + +> http://api.bilibili.com/x/v3/fav/resource/batch-del + +*请求方式：POST* + +认证方式：APP或Cookie（SESSDATA） + +**正文参数（ application/x-www-form-urlencoded ）：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| --------- | -------------- | ------------------------ | ------------------------------------------------------------ | ------- | +| resources | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}
每个成员间用`,`分隔
类型：
2：视频稿件
12：音频
21：视频合集
内容id：
视频稿件：视频稿件avid
音频：音频auid
视频合集：视频合集id | | +| media_id | num | 目标收藏夹id | 必要 | | +| platform | str | 平台标识 | 非必要 | 可为web | +| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
11010：您访问的内容不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | 成功为0 | + +**示例：** + +将id为`1178751999`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`取消收藏 + +```shell +curl 'http://api.bilibili.com/x/v3/fav/resource/batch-del' \ +--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' +``` + +
+查看响应示例： + + +```json +{ + "code":0, + "message":"0", + "ttl":1, + "data":0 +} +``` + +
+ +### 清空所有失效内容 > http://api.bilibili.com/x/v3/fav/resource/clean @@ -287,6 +474,7 @@ curl 'http://api.bilibili.com/x/v3/fav/resource/clean' \
查看响应示例： + ```json { "code":0,