github-repos/bilibili-API-collect

Fork 0

mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-03-13 18:00:11 +08:00

zjkwdy 7bf6562531 勘误

2021-02-27 16:33:41 +08:00

14 KiB

Raw Blame History

收藏夹操作

收藏夹操作

新建收藏夹(双端)

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

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

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

参数名	类型	内容	必要性	备注
access_key	str	APP登录Token	APP方式必要
appkey	str	APP密钥	APP方式必要	可为`1d8b6e7d45233436`
ts	num	时间戳（秒）	APP方式必要
title	str	收藏夹标题	必要
intro	str	收藏夹简介	非必要
privacy	num	是否公开	非必要	0公开 1私密
cover	str	封面图url	非必要	封面会被审核
csrf	str	CSRF Token	必要	位于Cookie
sign	str	APP签名	APP方式必要

json回复：

根对象：

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

data对象：

字段	类型	内容	备注
id	num	收藏夹id
fid	num	未知	不知道啥的id,后期补上
mid	num	创建者uid
attr	num	未知
title	str	收藏夹标题
cover	str	收藏夹封面图片url
upper	obj	创建者信息
cover_type	num	封面图类别（？）
cnt_info	obj	收藏夹数据	点赞观看收藏等
type	num	不知道是啥	一般是0
intro	str	简介
ctime	num	0	看起来意思是创建时间，但是是0
mtime	num	0	看起来意思是创建时间，但是是0
state	num	未知	一般为0
fav_state	num	收藏状态	已被自己收藏:1 未被自己收藏:0
like_state	num	点赞状态	同上
media_count	num	收藏夹内容数量

data对象中的upper对象

字段	类型	内容	备注
mid	num	0	谁也不知道知道为啥是空的
name	str	空	谁也不知道知道为啥是空的
face	str	空	谁也不知道知道为啥是空的
followed	bool	是否已关注创建者	肯定是false啦
vip_type	num	会员类别	0：无 1：月大会员 2：年度及以上大会员

data对象中的cnt_info对象

字段	类型	内容	备注
collect	num	收藏数	刚创建当然是0
play	num	播放数	刚创建当然是0
thumb_up	num	点赞数	刚创建当然是0
share	unm	分享数	刚创建当然是0

示例：

创建一个叫test,简介是2333,封面http://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 'csrf=xxxx' \
 --data-urlencode 'cover=http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \
 -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
    }
}

修改收藏夹(双端)

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

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

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

参数名	类型	内容	必要性	备注
access_key	str	APP登录Token	APP方式必要
appkey	str	APP密钥	APP方式必要	可为`1d8b6e7d45233436`
ts	num	时间戳（秒）	APP方式必要
title	str	新收藏夹标题	必要
intro	str	新收藏夹简介	非必要
privacy	num	是否公开	非必要	0公开 1私密
cover	str	封面图url	非必要	封面会被审核
csrf	str	CSRF Token	必要	位于Cookie
media_id	num	欲修改的收藏夹id	必要
sign	str	APP签名	APP方式必要

json回复：

根对象：

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

data对象：

字段	类型	内容	备注
id	num	收藏夹id
fid	num	未知	不知道啥的id,后期补上
mid	num	创建者uid
attr	num	未知
title	str	收藏夹标题
cover	str	收藏夹封面图片url
upper	obj	创建者信息
cover_type	num	封面图类别（？）
cnt_info	obj	收藏夹数据	点赞观看收藏等
type	num	不知道是啥	一般是11
intro	str	备注
ctime	num	创建时间	时间戳（秒）
mtime	num	收藏时间	时间戳（秒）
state	num	未知	一般为0
fav_state	num	收藏状态	已被自己收藏:1 未被自己收藏:0
like_state	num	点赞状态	同上
media_count	num	收藏夹内容数量

data对象中的upper对象

字段	类型	内容	备注
mid	num	创建者uid
name	str	创建者用户名
face	str	创建者头像url
followed	bool	是否已关注创建者
vip_type	num	会员类别	0：无 1：月大会员 2：年度及以上大会员
vip_statue	num	会员开通状态	0：无 1：有

data对象中的cnt_info对象

字段	类型	内容
collect	num	收藏数
play	num	播放数
thumb_up	num	点赞数
share	unm	分享数

示例：

修改id为1182306172的名字为test,简介为2333,封面为http://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=http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \
 --data-urlencode 'media_id=1182306172' \
 --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
    }
}

删除收藏夹(双端)

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

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

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

参数名	类型	内容	必要性	备注
access_key	str	APP登录Token	APP方式必要
appkey	str	APP密钥	APP方式必要	可为`1d8b6e7d45233436`
ts	num	时间戳（秒）	APP方式必要
media_ids	num	收藏夹id	必要	看名字貌似可以多个
csrf	str	CSRF Token (位于Cookie)	必要
sign	str	APP签名	APP方式必要

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 'csrf=xxxx' \
 --data-urlencode 'media_ids=1182306172' \
 -b 'SESSDATA=xxxx'

查看响应示例：

{
    "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 ）：

参数名	类型	内容	必要性	备注
access_key	str	APP登录Token	APP方式必要
appkey	str	APP密钥	APP方式必要	可为`1d8b6e7d45233436`
csrf	str	CSRF Token	必要	位于Cookie
media_id	num	欲清理的收藏夹id	必要
sign	str	APP签名	APP方式必要

json回复：

根对象：

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

示例：

清理id为1161340172的收藏夹:

curl -G 'https://api.bilibili.com/x/v3/fav/resource/clean' \
 --data-urlencode 'csrf=563e9d79a8e289dbd96604668edfa802' \
 --data-urlencode 'media_id=1161340172' \
 -b 'SESSDATA=00cbbdf2%2C1628861933%2Ce228c%2A21; bili_jct=563e9d79a8e289dbd96604668edfa802;'

查看响应示例：

{
    "code":0,
    "message":"0",
    "ttl":1,
    "data":0
}

14 KiB Raw Blame History Unescape Escape

收藏夹操作

新建收藏夹(双端)

修改收藏夹(双端)

删除收藏夹(双端)

清空所有失效内容(双端)

14 KiB

Raw Blame History