github-repos/bilibili-API-collect

Fork 0

mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-29 14:00:09 +08:00

SocialSisterYi ad1fb40194 添加评论区明细以及用户最近的游戏

2020-06-12 14:10:21 +08:00

22 KiB

Raw Blame History

播放历史

获取视频播放历史

http://api.bilibili.com/x/v2/history

方式：GET

需要登录(SESSDATA)

url参数：

参数名	类型	内容	必要性	备注
pn	num	页码	非必要	默认为1
ps	num	每页项数	非必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -400：请求错误
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确
data	array	历史记录列表

data数组：

项	类型	内容	备注
0	obj	历史观看1
n	obj	历史观看(n+1)	按照观看顺序排列项数为总计观看视频数
……	obj	……	……

data数组中的对象：

字段	类型	内容	备注
aid	num	视频avID
videos	num	视频分P总数	默认为1
tid	num	分区ID
tname	str	子分区名称
copyright	num	版权标志	1：自制 2：转载
pic	str	视频封面图片url
title	str	视频标题
pubdate	num	视频上传时间	时间戳
ctime	num	视频审核通过时间	时间戳
desc	str	视频简介
state	num	0	作用尚不明确
attribute	num	？？？	作用尚不明确
duration	num	视频总计持续时长（所有分P）	单位为秒
rights	obj	视频属性标志
owner	obj	视频UP主信息
stat	obj	视频状态数
dynamic	str	视频同步发布的的动态的文字内容	无为空
cid	num	视频1P CID
dimension	obj	视频1P分辨率
bangumi	obj	番剧/影视信息	非番剧/影视无此项
cheese	obj	课程信息	非课程无此项
favorite	bool	是否已收藏	true：已收藏 false：未收藏
type	num	视频属性	3：普通视频 4：番剧/影视 10：课程
sub_type	num	附视频属性	0：普通视频 1：番剧 2：电影 3：纪录片 4：国创 5：电视剧 7：综艺
device	num	观看设备	1 3 5 7：手机端 2：PC端 4 6：PAD端 33：TV端 0：其他
page	obj	最后观看的分P信息
count	num	分P数	非投稿视频无此项
progress	num	观看进度	单位为秒
view_at	num	观看时间	时间戳
kid	num	视频avID
business	str	视频类型标识	archive：用户投稿视频 pgc：番剧/影视 cheese：课程
redirect_link	str	重定向url
bvid	str	视频bvID

data数组中的对象中的rights对象：

字段	类型	内容	备注
bp	num	0	作用尚不明确
elec	num	0	作用尚不明确
download	num	允许下载标志	0：不允许 1：允许
movie	num	视频时电影标志	0：否 1：是
pay	num	仅会员可观看标志	0：无 1：有
hd5	num	有高码率标志	0：无 1：有
no_reprint	num	禁止转载标志	0：无 1：禁止
autoplay	num	可自动播放标志	0：无 1：有区别影视番剧与普通视频
ugc_pay	num	0	作用尚不明确
is_cooperation	num	视频合作标志	0：无 1：是
ugc_pay_preview	num	0	作用尚不明确
no_background	num	0	作用尚不明确

data数组中的对象中的owner对象：

字段	类型	内容
mid	num	UP主UID
name	str	UP主昵称
face	str	UP主头像

data数组中的对象中的stat对象：

字段	类型	内容	备注
aid	num	视频avID
view	num	普通：观看次数屏蔽时：-1
danmaku	num	弹幕条数
reply	num	评论条数
favorite	num	收藏人数
coin	num	投币枚数
share	num	分享次数
now_rank	num	0	作用尚不明确
his_rank	num	历史最高排行
like	num	获赞次数
dislike	num	0	作用尚不明确
evaluation	str	视频评分	默认为空

pages对象：

字段	类型	内容	备注
cid	num	当前分P CID
page	num	当前分P
from	str	视频来源	vupload：用户上传 hunan：芒果TV
part	str	当前分P标题
duration	num	当前分P持续时间	单位为秒
vid	str	空	作用尚不明确
weblink	str	空	作用尚不明确
dimension	obj	当前分P分辨率

pages中的dimension对象(同data数组中的对象中的dimension对象)：

字段	类型	内容	备注
width	num	当前分P 宽度	可能为0
height	num	当前分P 高度	可能为0
rotate	num	0	作用尚不明确

data数组中的对象bangumi对象：

字段	类型	内容	备注
cover	str	番剧封面图片url
ep_id	num	番剧epID
episode_status	num	？？？
follow	num	0	作用尚不明确
long_title	str	单集标题
season	obj	剧集信息
title	str	集数

bangumi中的season对象：

字段	类型	内容	备注
is_finish	num	是否完结	0：连载中 1：完结
newest_ep_id	num	最细一话epID
newest_ep_index	str	最细一话集数
season_id	num	番剧ssID
season_status	num	？？？
season_type	num	？？？
title	str	番剧标题
total_count	num	总集数

data数组中的对象cheese对象：

字段	类型	内容
cover	str	课程封面图片url
long_title	str	完整标题
number	str	本集数
season_id	num	课程ssID
update_info	str	总集数

示例：

查询当前视频历史记录列表

http://api.bilibili.com/x/v2/history?ps=5&pn=1

{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": [
        {
            "aid": 96523832,
            "videos": 1,
            "tid": 33,
            "tname": "连载动画",
            "copyright": 2,
            "pic": "http://i0.hdslb.com/bfs/archive/dfc29be381565ee041a0ec9cfc7a32f8a63f76cd.jpg",
            "title": "【1月】异度侵入 ID:INVADED 12【独家正版】",
            "pubdate": 1584289800,
            "ctime": 1584289800,
            "desc": "#12",
            "state": 0,
            "attribute": 338688,
            "duration": 1481,
            "redirect_url": "https://www.bilibili.com/bangumi/play/ep307457",
            "rights": {
                "bp": 0,
                "elec": 0,
                "download": 0,
                "movie": 0,
                "pay": 1,
                "hd5": 1,
                "no_reprint": 0,
                "autoplay": 0,
                "ugc_pay": 0,
                "is_cooperation": 0,
                "ugc_pay_preview": 0,
                "no_background": 0
            },
            "owner": {
                "mid": 928123,
                "name": "哔哩哔哩番剧",
                "face": "http://i1.hdslb.com/bfs/face/7a8412cbacb9fd18f40ddbbf0ad183e45afc1365.jpg"
            },
            "stat": {
                "aid": 96523832,
                "view": 4772927,
                "danmaku": 108890,
                "reply": 48584,
                "favorite": 46,
                "coin": 61768,
                "share": 290,
                "now_rank": 0,
                "his_rank": 0,
                "like": 1241,
                "dislike": 0
            },
            "dynamic": "",
            "cid": 164789275,
            "dimension": {
                "width": 1920,
                "height": 1080,
                "rotate": 0
            },
            "favorite": false,
            "type": 4,
            "sub_type": 1,
            "device": 3,
            "page": {
                "cid": 164789275,
                "page": 1,
                "from": "vupload",
                "part": "ID_INVADED_112.encoded",
                "duration": 1481,
                "vid": "",
                "weblink": "",
                "dimension": {
                    "width": 1920,
                    "height": 1080,
                    "rotate": 0
                }
            },
            "bangumi": {
                "ep_id": 307457,
                "title": "12",
                "long_title": "CHANNELED",
                "episode_status": 13,
                "follow": 0,
                "cover": "http://i0.hdslb.com/bfs/archive/dfc29be381565ee041a0ec9cfc7a32f8a63f76cd.jpg",
                "season": {
                    "season_id": 29310,
                    "title": "异度侵入 ID:INVADED",
                    "season_status": 13,
                    "is_finish": 1,
                    "total_count": 13,
                    "newest_ep_id": 307774,
                    "newest_ep_index": "13",
                    "season_type": 1
                }
            },
            "progress": 277,
            "view_at": 1588831600,
            "kid": 29310,
            "business": "pgc",
            "redirect_link": "https://www.bilibili.com/bangumi/play/ep307457",
            "bvid": "BV1K7411f7uu"
        },
        {
            "aid": 497899395,
            "videos": 1,
            "tid": 189,
            "tname": "电脑装机",
            "copyright": 1,
            "pic": "http://i0.hdslb.com/bfs/archive/fd4e0893b234ee729cf15198065eced98367ebfe.jpg",
            "title": "600元的2007款iMac，如今过时了吗？",
            "pubdate": 1587727345,
            "ctime": 1587708111,
            "desc": "苹果东西是真的保值，酷睿2现在都还能卖的这么贵。第一次使用4K画质进行拍摄，应该比以前清楚一些。如有问题请在评论区指出，谢谢！",
            "state": 0,
            "attribute": 16768,
            "duration": 389,
            "mission_id": 13106,
            "rights": {
                "bp": 0,
                "elec": 0,
                "download": 0,
                "movie": 0,
                "pay": 0,
                "hd5": 1,
                "no_reprint": 1,
                "autoplay": 1,
                "ugc_pay": 0,
                "is_cooperation": 0,
                "ugc_pay_preview": 0,
                "no_background": 0
            },
            "owner": {
                "mid": 3391089,
                "name": "数字云糕Official",
                "face": "http://i2.hdslb.com/bfs/face/238dfbca5dda5de2d5ba95ee4e99804714e2b5e2.jpg"
            },
            "stat": {
                "aid": 497899395,
                "view": 23325,
                "danmaku": 92,
                "reply": 115,
                "favorite": 195,
                "coin": 132,
                "share": 23,
                "now_rank": 0,
                "his_rank": 0,
                "like": 555,
                "dislike": 0
            },
            "dynamic": "#IMAC##APPLE##MAC# 苹果东西是真的保值，酷睿2现在都还能卖的这么贵。第一次使用4K画质进行拍摄，应该比以前清楚一些。",
            "cid": 182570131,
            "dimension": {
                "width": 1920,
                "height": 1080,
                "rotate": 0
            },
            "favorite": false,
            "type": 3,
            "sub_type": 0,
            "device": 3,
            "page": {
                "cid": 182570131,
                "page": 1,
                "from": "vupload",
                "part": "iMac",
                "duration": 389,
                "vid": "",
                "weblink": "",
                "dimension": {
                    "width": 1920,
                    "height": 1080,
                    "rotate": 0
                }
            },
            "count": 1,
            "progress": -1,
            "view_at": 1588828357,
            "kid": 497899395,
            "business": "archive",
            "redirect_link": "https://www.bilibili.com/video/av497899395",
            "bvid": "BV1NK41157EF"
        }
    ]
}

删除视频观看历史记录

http://api.bilibili.com/x/v2/history/delete

方式：POST

需要登录(SESSDATA)

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

参数名	类型	内容	必要性	备注
kid	str	删除的目标记录	必要	格式：archive_{视频avID}
csrf	str	cookies中的bili_jct	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败 -400：请求错误
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确

示例：

删除视频av540580868的观看历史记录

curl -b "SESSDATA=xxx" -d "kid=archive_540580868&csrf=xxx" "http://api.bilibili.com/x/v2/history/delete"

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

清空历史记录

http://api.bilibili.com/x/v2/history/clear

方式：POST

需要登录(SESSDATA)

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

参数名	类型	内容	必要性	备注
csrf	str	cookies中的bili_jct	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确

示例：

清空历史记录

curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/v2/history/clear"

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

停用历史记录

http://api.bilibili.com/x/v2/history/shadow/set

方式：POST

需要登录(SESSDATA)

该功能不会影响历史记录的保存于删除

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

参数名	类型	内容	必要性	备注
switch	bool	停用开关	非必要	true：停用 false：正常默认为false
csrf	str	cookies中的bili_jct	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -111：csrf校验失败
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确

示例：

停用历史记录功能

curl -b "SESSDATA=xxx" -d "switch=true&csrf=xxx" "http://api.bilibili.com/x/v2/history/shadow/set"

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

查询历史记录停用状态

http://api.bilibili.com/x/v2/history/shadow

方式：GET

需要登录(SESSDATA)

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确
data	bool	停用状态	true：停用 false：正常

示例：

当前状态为未停用视频历史记录

http://api.bilibili.com/x/v2/history/shadow

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

22 KiB Raw Blame History Unescape Escape

播放历史

获取视频播放历史

删除视频观看历史记录

清空历史记录

停用历史记录

查询历史记录停用状态

22 KiB

Raw Blame History