github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00
Code Issues Packages Projects Releases Wiki Activity
c80d0e5f9f
bilibili-API-collect/fav/action.md
SocialSisterYi 69ba9bea19
修改README，全栈替换http为https
2023-01-17 15:23:59 +08:00

16 KiB
Raw Blame History

收藏夹操作

管理收藏夹

新建收藏夹

https://api.bilibili.com/x/v3/fav/folder/add

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

正文参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
title str 收藏夹标题 必要
intro str 收藏夹简介 非必要 默认为空
privacy num 是否公开 非必要 默认为公开
0：公开
1：私密
cover str 封面图url 非必要 封面会被审核
csrf str CSRF Token（位于cookie） Cookie方式必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-102：账号被封停
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

略....

详见获取收藏夹元数据中的data对象

示例：

创建一个叫test,简介是2333,封面https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png,的公开收藏夹:

curl 'https://api.bilibili.com/x/v3/fav/folder/add' \
--data-urlencode 'title=test' \
--data-urlencode 'intro=2333' \
--data-urlencode 'privacy=0' \
--data-urlencode 'cover=https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \
--data-urlencode 'csrf=xxxx' \
-b 'SESSDATA=xxxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "id": 1182306172,
        "fid": 11823061,
        "mid": 470310172,
        "attr": 6,
        "title": "test",
        "cover": "https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
        "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
    }
}

修改收藏夹

https://api.bilibili.com/x/v3/fav/folder/edit

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

正文参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
media_id num 目标收藏夹mdid 必要
title str 修改收藏夹标题 必要
intro str 修改收藏夹简介 非必要
privacy num 是否公开 非必要 默认为公开

0：公开
1：私密
cover str 封面图url 非必要 封面会被审核
csrf str CSRF Token（位于cookie） Cookie方式必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-102：账号被封停
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

略....

详见获取收藏夹元数据中的data对象

示例：

修改id为1182306172的名字为test,简介为2333,封面为https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png,公开收藏夹:

curl 'https://api.bilibili.com/x/v3/fav/folder/edit' \
--data-urlencode 'media_id=1182306172' \
--data-urlencode 'title=test' \
--data-urlencode 'intro=2333' \
--data-urlencode 'privacy=0' \
--data-urlencode 'cover=https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \
--data-urlencode 'csrf=xxxx' \
-b 'SESSDATA=xxxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "id": 1182306172,
        "fid": 11823061,
        "mid": 470310172,
        "attr": 6,
        "title": "test",
        "cover": "https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
        "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
    }
}

删除收藏夹

https://api.bilibili.com/x/v3/fav/folder/del

请求方式：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的收藏夹:

curl 'https://api.bilibili.com/x/v3/fav/folder/del' \
--data-urlencode 'media_ids=1182306172' \
--data-urlencode 'csrf=xxxx' \
-b 'SESSDATA=xxxx'
查看响应示例： 
{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":0
}

管理收藏内容

批量复制内容

https://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的收藏夹中

curl 'https://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'
查看响应示例： 
{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":0
}

批量移动内容

https://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的收藏夹中

curl 'https://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'
查看响应示例： 
{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":0
}

批量删除内容

https://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取消收藏

curl 'https://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'
查看响应示例： 
{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":0
}

清空所有失效内容

https://api.bilibili.com/x/v3/fav/resource/clean

请求方式：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的收藏夹

curl 'https://api.bilibili.com/x/v3/fav/resource/clean' \
--data-urlencode 'media_id=1161340172' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":0
}