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
a15ce711ce
bilibili-API-collect/history&toview/toview.md

525 lines
19 KiB
Markdown
Raw Normal View History

添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
# 稍后再看
添加充电列表与视频流地址的api
2020-05-16 00:34:06 +08:00
<img src="/imgs/toview.png" width="25" height="25"/>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
## 视频添加稍后再看
>http://api.bilibili.com/x/v2/history/toview/add
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
认证方式：Cookie（SESSDATA）
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
最多添加100个视频
优化文档格式
2020-06-08 22:44:46 +08:00
**正文参数（ application/x-www-form-urlencoded ）：**
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
添加api鉴权说明
2020-07-09 16:34:50 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />90001：列表已满<br />90003：稿件已经被删除 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**示例：**
添加视频`av41687433`/`BV1ht41147kj`到稍后再看列表
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
avID方式：
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
```shell
curl 'http://api.bilibili.com/x/v2/history/toview/add'\
--data-urlencode 'aid=41687433'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
bvID方式：
```shell
curl 'http://api.bilibili.com/x/v2/history/toview/add'\
--data-urlencode 'bvid=BV1ht41147kj'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
## 添加频道中所有视频到稍后再看
> http://space.bilibili.com/ajax/channel/addAllToView
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
认证方式：Cookie（SESSDATA）
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
鉴权方式：Cookie中`DedeUserID`及`DedeUserID__ckMd5`存在且不为0，referer为 `.bilibili.com`域名下
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
带有转义
超过容量后会截取容量之内的添加
优化文档格式
2020-06-08 22:44:46 +08:00
**正文参数（ application/x-www-form-urlencoded ）：**
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
添加api鉴权说明
2020-07-09 16:34:50 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 目标频道ID | 必要 | |
| mid | num | 目标频道所属的用户UID | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | -------- | --------------------------- |
| status | bool | 是否成功 | false：失败<br />true：成功 |
| data | str | 错误信息 | |
**示例：**
添加用户`UID=282994`下的频道`4693`中所有视频到稍后再看
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
```shell
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'
```
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
```json
{
"status": true,
"data": "操作成功"
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
## 获取稍后再看视频列表
> http://api.bilibili.com/x/v2/history/toview
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
认证方式：Cookie（SESSDATA）
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
| data | data | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ------ | ---------------- | ---- |
| count | num | 稍后再看视频数 | |
添加评论区明细以及用户最近的游戏
2020-06-12 14:10:21 +08:00
| list | array | 稍后再看视频列表 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
`data`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------------------------------------- |
| 0 | obj | 稍后再看1 | |
| n | obj | 稍后再看(n+1) | 按照添加顺序排列<br />项数为总计稍后再看视频数 |
| …… | obj | …… | …… |
| 99 | obj | 最后一项 | |
`data`中的`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ------------------------------ | -------------------- |
| aid | num | 视频avID | |
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区ID | |
| tname | str | 子分区名称 | |
| copyright | num | 版权标志 | 1：自制<br />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 | 视频同步发布的的动态的文字内容 | 无为空 |
| dimension | obj | 视频1P分辨率 | |
| count | num | 分P数 | 非投稿视频无此项 |
| cid | num | 视频CID | |
| progress | num | 观看进度时间 | 单位为秒 |
| add_at | num | 添加时间 | 时间戳 |
| bvid | str | 视频bvID | |
`data`中的`list`数组中的对象中的`rights`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ---------------------------------------- |
| bp | num | 0 | 作用尚不明确 |
| elec | num | 0 | 作用尚不明确 |
| download | num | 允许下载标志 | 0：不允许<br />1：允许 |
| movie | num | 视频时电影标志 | 0：否<br />1：是 |
| pay | num | 仅会员可观看标志 | 0：无<br />1：有 |
| hd5 | num | 有高码率标志 | 0：无<br />1：有 |
| no_reprint | num | 禁止转载标志 | 0：无<br />1：禁止 |
| autoplay | num | 可自动播放标志 | 0：无<br />1：有 区别影视番剧与普通视频 |
| ugc_pay | num | 0 | 作用尚不明确 |
| is_cooperation | num | 视频合作标志 | 0：无<br />1：是 |
| ugc_pay_preview | num | 0 | 作用尚不明确 |
| no_background | num | 0 | 作用尚不明确 |
`data`中的`list`数组中的对象中的`owner`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| mid | num | UP主UID | |
| name | str | UP主昵称 | |
| face | str | UP主头像 | |
`data`中的`list`数组中的对象中的`stat`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------------ | ------------ |
| aid | num | 视频avID | |
| view | num | 普通：观看次数<br />屏蔽时：-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 | 视频评分 | 默认为空 |
`data`中的`list`数组中的对象中的`pages`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | ------------------------------------ |
| cid | num | 当前分P CID | |
| page | num | 当前分P | |
| from | str | 视频来源 | vupload：用户上传<br />hunan：芒果TV |
| part | str | 当前分P标题 | |
| duration | num | 当前分P持续时间 | 单位为秒 |
| vid | str | 空 | 作用尚不明确 |
| weblink | str | 空 | 作用尚不明确 |
| dimension | obj | 当前分P分辨率 | |
`pages`中的`dimension`对象(同`data`中的`list`数组中的对象中的`dimension`对象)：
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | -------------- | -------------------- |
| width | num | 当前分P 宽度 | 可能为0 |
| height | num | 当前分P 高度 | 可能为0 |
| rotate | num | 是否将宽高对换 | 0：正常<br />1：对换 |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**示例：**
获取稍后再看视频列表
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
```shell
curl 'http://api.bilibili.com/x/v2/history/toview'\
-b 'SESSDATA=xxx'
```
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
```json
"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"
},
…………
]
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
## 删除稍后再看视频
> http://api.bilibili.com/x/v2/history/toview/del
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
认证方式：Cookie（SESSDATA）
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
优化文档格式
2020-06-08 22:44:46 +08:00
**正文参数（ application/x-www-form-urlencoded ）：**
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
优化文档格式
2020-06-08 22:44:46 +08:00
| viewed | bool | 是否删除所有已观看的视频 | 非必要 | true：删除已观看视频<br />false：不删除已观看视频<br />默认为false |
| aid | num | 删除的目标记录的avID | 非必要 | |
添加api鉴权说明
2020-07-09 16:34:50 +08:00
| csrf | str | CSRF Token（位于cookie） | 必要 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**示例：**
删除视频`av540580868`的稍后再看记录
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
```shell
curl 'http://api.bilibili.com/x/v2/history/toview/del'\
--data-urlencode 'aid=540580868'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
删除所有已观看的视频
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
```shell
curl 'http://api.bilibili.com/x/v2/history/toview/del'\
--data-urlencode 'viewed=true'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
## 清空稍后再看视频列表
> http://api.bilibili.com/x/v2/history/toview/clear
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
认证方式：Cookie（SESSDATA）
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
优化文档格式
2020-06-08 22:44:46 +08:00
**正文参数（ application/x-www-form-urlencoded ）：**
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
添加api鉴权说明
2020-07-09 16:34:50 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| csrf | num | CSRF Token（位于cookie） | 必要 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
**示例：**
清空稍后再看视频列表
继续修改文档格式 补完TV端扫码登录
2020-07-18 23:56:10 +08:00
```shell
curl 'http://api.bilibili.com/x/v2/history/toview/clear'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
添加购买高级弹幕权限及个人中心和稍后再看的若干api
2020-05-10 18:25:23 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
Reference in New Issue Copy Permalink