Skip to content

Latest commit

 

History

History
486 lines (365 loc) · 16.3 KB

action.md

File metadata and controls

486 lines (365 loc) · 16.3 KB

收藏夹操作


管理收藏夹

新建收藏夹

http://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:成功
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象:

略....

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

示例:

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

curl 'http://api.bilibili.com/x/v3/fav/folder/add' \
--data-urlencode 'title=test' \
--data-urlencode 'intro=2333' \
--data-urlencode 'privacy=0' \
--data-urlencode 'cover=http://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": "http://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
    }
}

修改收藏夹

http://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:成功
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象:

略....

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

示例:

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

curl 'http://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=http://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": "http://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
    }
}

删除收藏夹

http://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 'http://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
}

管理收藏内容

批量复制内容

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的收藏夹

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'
查看响应示例:
{
    "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的收藏夹

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'
查看响应示例:
{
    "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取消收藏

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

清空所有失效内容

http://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 'http://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
}