import{_ as p,c as d,a as t,b as a,d as n,e,w as o,r,o as c}from"./app-Dgsdh8A6.js";const i={};function D(u,s){const l=r("RouteLink");return c(),d("div",null,[s[10]||(s[10]=t('

收藏夹操作

管理收藏夹

新建收藏夹

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

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

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

参数名类型内容必要性备注
titlestr收藏夹标题必要
introstr收藏夹简介非必要默认为空
privacynum是否公开非必要默认为公开
0：公开
1：私密
coverstr封面图url非必要封面会被审核
csrfstrCSRF Token（位于cookie）Cookie方式必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-102：账号被封停
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象：

略....

',13)),a("p",null,[s[1]||(s[1]=n("详见")),e(l,{to:"/docs/fav/info.html#%E8%8E%B7%E5%8F%96%E6%94%B6%E8%97%8F%E5%A4%B9%E5%85%83%E6%95%B0%E6%8D%AE"},{default:o(()=>s[0]||(s[0]=[n("获取收藏夹元数据")])),_:1,__:[0]}),s[2]||(s[2]=n("中的")),s[3]||(s[3]=a("code",null,"data",-1)),s[4]||(s[4]=n("对象"))]),s[11]||(s[11]=t(`

示例：

创建一个叫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_idnum目标收藏夹mdid必要
titlestr修改收藏夹标题必要
introstr修改收藏夹简介非必要
privacynum是否公开非必要默认为公开

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

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-102：账号被封停
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data对象：

略....

`,15)),a("p",null,[s[6]||(s[6]=n("详见")),e(l,{to:"/docs/fav/info.html#%E8%8E%B7%E5%8F%96%E6%94%B6%E8%97%8F%E5%A4%B9%E5%85%83%E6%95%B0%E6%8D%AE"},{default:o(()=>s[5]||(s[5]=[n("获取收藏夹元数据")])),_:1,__:[5]}),s[7]||(s[7]=n("中的")),s[8]||(s[8]=a("code",null,"data",-1)),s[9]||(s[9]=n("对象"))]),s[12]||(s[12]=t(`

示例：

修改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_idsnums目标收藏夹mdid列表必要每个成员间用,分隔
csrfstrCSRF Token（位于cookie）Cookie方式必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
messagestr错误信息成功为0
ttlnum1
datanum信息本体成功为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_idnum源收藏夹id必要
tar_media_idnum目标收藏夹id必要
midnum当前用户mid必要
resourcesstrs目标内容id列表必要格式：{内容id}:{内容类型}
每个成员间用,分隔
类型：
2：视频稿件
12：音频
21：视频合集
内容id：
视频稿件：视频稿件avid
音频：音频auid
视频合集：视频合集id
platformstr平台标识非必要可为web
csrfstrCSRF Token（位于cookie）Cookie方式必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
11010：您访问的内容不存在
messagestr错误信息默认为0
ttlnum1
dataobj信息本体成功为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_idnum源收藏夹id必要
tar_media_idnum目标收藏夹id必要
midnum当前用户mid必要
resourcesstrs目标内容id列表必要格式：{内容id}:{内容类型}
每个成员间用,分隔
类型：
2：视频稿件
12：音频
21：视频合集
内容id：
视频稿件：视频稿件avid
音频：音频auid
视频合集：视频合集id
platformstr平台标识非必要可为web
csrfstrCSRF Token（位于cookie）Cookie方式必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
11010：您访问的内容不存在
messagestr错误信息默认为0
ttlnum1
dataobj信息本体成功为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_idnum目标收藏夹id必要
platformstr平台标识非必要可为web
csrfstrCSRF Token（位于cookie）Cookie方式必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
11010：您访问的内容不存在
messagestr错误信息默认为0
ttlnum1
dataobj信息本体成功为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_idnum目标收藏夹id必要
csrfstrCSRF Token（位于cookie）Cookie方式必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
messagestr错误信息默认为0
ttlnum1
dataobj信息本体成功为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
}
`,70))])}const v=p(i,[["render",D]]),b=JSON.parse('{"path":"/docs/fav/action.html","title":"收藏夹操作","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1677124138000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"}],"changelog":[{"hash":"f6760f4be38d5b592d396b211e48c666286524de","time":1677124138000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🔨remove header index"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/fav/action.md"}');export{v as comp,b as data};