github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-29 14:00:09 +08:00
Code Issues Packages Projects Releases Wiki Activity
e7efbd0ae5
bilibili-API-collect/history&toview/toview.md
SocialSisterYi e7efbd0ae5 所有文档添加索引目录
2020-11-20 20:13:12 +08:00

18 KiB
Raw Blame History

稍后再看

视频添加稍后再看

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

请求方式：POST

认证方式：Cookie（SESSDATA）

最多添加100个视频

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

参数名 类型 内容 必要性 备注
aid num 稿件avID 必要（可选） avID与bvID任选一个
bvid str 稿件bvID 必要（可选） avID与bvID任选一个
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
90001：列表已满
90003：稿件已经被删除
message str 错误信息 默认为0
ttl num 1

示例：

添加视频av41687433/BV1ht41147kj到稍后再看列表

avID方式：

curl 'http://api.bilibili.com/x/v2/history/toview/add' \
--data-urlencode 'aid=41687433' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

bvID方式：

curl 'http://api.bilibili.com/x/v2/history/toview/add' \
--data-urlencode 'bvid=BV1ht41147kj' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

添加频道中所有视频到稍后再看

http://space.bilibili.com/ajax/channel/addAllToView

请求方式：POST

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中DedeUserID及DedeUserID__ckMd5存在且不为0，referer为 .bilibili.com域名下

带有转义

超过容量后会截取容量之内的添加

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

参数名 类型 内容 必要性 备注
cid num 目标频道ID 必要
mid num 目标频道所属的用户UID 必要
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

字段 类型 内容 备注
status bool 是否成功 false：失败
true：成功
data str 错误信息

示例：

添加用户UID=282994下的频道4693中所有视频到稍后再看

curl 'http://space.bilibili.com/ajax/channel/addAllToView' \
--data-urlencode 'cid=4693' \
--data-urlencode 'mid=282994' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;'
-e 'https://www.bilibili.com'
查看响应示例： 
{
    "status": true,
    "data": "操作成功"
}

获取稍后再看视频列表

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

请求方式：GET

认证方式：Cookie（SESSDATA）

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
message str 错误信息 默认为0
ttl num 1
data data 数据本体

data对象：

字段 类型 内容 备注
count num 稍后再看视频数
list array 稍后再看视频列表

data中的list数组：

项 类型 内容 备注
0 obj 稍后再看1
n obj 稍后再看(n+1) 按照添加顺序排列
项数为总计稍后再看视频数
…… obj …… ……
99 obj 最后一项

data中的list数组中的对象：

字段 类型 内容 备注
aid num 稿件avID
videos num 稿件分P总数 默认为1
tid num 分区tID
tname str 子分区名称
copyright num 是否转载 1：原创
2：转载
pic str 稿件封面图片url
title str 稿件标题
pubdate num 稿件发布时间 时间戳
ctime num 用户提交稿件的时间 时间戳
desc str 视频简介
state num 视频状态 略，见获取视频详细信息（web端）中的state备注
attribute（仅做历史性保留） num 稿件属性位配置 本字段已被删除略，见获取视频详细信息（web端）中的attribute备注
duration num 稿件总时长（所有分P） 单位为秒
rights obj 稿件属性标志 略，见获取视频详细信息（web端）中的rights对象
owner obj 稿件UP主信息 略，见获取视频详细信息（web端）中的owner对象
stat obj 稿件状态数 略，见获取视频详细信息（web端）中的stat对象
dynamic str 视频同步发布的的动态的文字内容 无为空
dimension obj 稿件1P分辨率 略，见获取视频详细信息（web端）中的dimension对象
count num 稿件分P数 非投稿视频无此项
cid num 视频CID
progress num 观看进度时间 单位为秒
add_at num 添加时间 时间戳
bvid str 稿件bvID

示例：

获取稍后再看视频列表

curl 'http://api.bilibili.com/x/v2/history/toview' \
-b 'SESSDATA=xxx'
查看响应示例： 
 "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "count": 25,
        "list": [
            {
                "aid": 200333024,
                "videos": 1,
                "tid": 95,
                "tname": "手机平板",
                "copyright": 1,
                "pic": "http://i1.hdslb.com/bfs/archive/a5e3072e670daec4c01a182aae91c1f85a48001e.jpg",
                "title": "【山新】疫情下，配音演员怎么开工录音？",
                "pubdate": 1586959137,
                "ctime": 1586959137,
                "desc": "疫情这段时间，配音演员们是怎么录音的呢=W=",
                "state": 0,
                "attribute": 16768,
                "duration": 218,
                "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": 14082,
                    "name": "山新",
                    "face": "http://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg"
                },
                "stat": {
                    "aid": 200333024,
                    "view": 361123,
                    "danmaku": 1792,
                    "reply": 1376,
                    "favorite": 7571,
                    "coin": 12129,
                    "share": 895,
                    "now_rank": 0,
                    "his_rank": 0,
                    "like": 54705,
                    "dislike": 0
                },
                "dynamic": "疫情这段时间，配音演员们是怎么录音的呢=W=",
                "dimension": {
                    "width": 3840,
                    "height": 2160,
                    "rotate": 0
                },
                "page": {
                    "cid": 178808041,
                    "page": 1,
                    "from": "vupload",
                    "part": "无标题",
                    "duration": 218,
                    "vid": "",
                    "weblink": "",
                    "dimension": {
                        "width": 3840,
                        "height": 2160,
                        "rotate": 0
                    }
                },
                "count": 1,
                "cid": 178808041,
                "progress": 32,
                "add_at": 1587041785,
                "bvid": "BV1Yz411B7n3"
            },
            {
                "aid": 710350011,
                "videos": 1,
                "tid": 124,
                "tname": "趣味科普人文",
                "copyright": 1,
                "pic": "http://i0.hdslb.com/bfs/archive/c5b7e7c07a4abf27029c5afb3ab65fee4475b9a9.jpg",
                "title": "不花一分钱建立自己的网站！给硬盘里的小姐姐换个新家！",
                "pubdate": 1586919626,
                "ctime": 1586898238,
                "desc": "制作视频不易，你的点赞是对我最大的支持！\nUP主的个人网站：https://amdradeonrin.github.io/MIKU/\n视频提到的文件在网站有下载\nGitHub上的网站源码：https://github.com/AMDRadeonRin/MIKU",
                "state": 0,
                "attribute": 16768,
                "duration": 169,
                "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": 179757857,
                    "name": "GTX690战术核显卡导弹",
                    "face": "http://i2.hdslb.com/bfs/face/2504de8c1eeef22d91bbc45803f6b29afcbb0adf.jpg"
                },
                "stat": {
                    "aid": 710350011,
                    "view": 3293,
                    "danmaku": 37,
                    "reply": 117,
                    "favorite": 355,
                    "coin": 76,
                    "share": 11,
                    "now_rank": 0,
                    "his_rank": 0,
                    "like": 325,
                    "dislike": 0
                },
                "dynamic": "#网页制作##HTML##网页#给你们科普一下怎么弄网站吧，你们也可以考虑整一个XD",
                "dimension": {
                    "width": 1920,
                    "height": 1080,
                    "rotate": 0
                },
                "count": 1,
                "cid": 0,
                "progress": 0,
                "add_at": 1587012410,
                "bvid": "BV1LQ4y1T7Xh"
            },
            …………
        ]
    }
}

删除稍后再看视频

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

请求方式：POST

认证方式：Cookie（SESSDATA）

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

参数名 类型 内容 必要性 备注
viewed bool 是否删除所有已观看的视频 非必要 true：删除已观看视频
false：不删除已观看视频
默认为false
aid num 删除的目标记录的avID 非必要
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

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

示例：

删除视频av540580868的稍后再看记录

curl 'http://api.bilibili.com/x/v2/history/toview/del' \
--data-urlencode 'aid=540580868' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

删除所有已观看的视频

curl 'http://api.bilibili.com/x/v2/history/toview/del' \
--data-urlencode 'viewed=true' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

清空稍后再看视频列表

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

请求方式：POST

认证方式：Cookie（SESSDATA）

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

参数名 类型 内容 必要性 备注
csrf num CSRF Token（位于cookie） 必要

json回复：

根对象：

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

示例：

清空稍后再看视频列表

curl 'http://api.bilibili.com/x/v2/history/toview/clear' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}