github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-04-02 11:20:12 +08:00
Code Issues Packages Projects Releases Wiki Activity
c84e72504e
bilibili-API-collect/fav/action.md
SocialSisterYi c84e72504e 勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:33:41 +08:00

8.1 KiB
Raw Blame History

收藏夹操作

新建收藏夹

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/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
}