From cf3585f00d6e357593e377f8623607bcc0264c16 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=A4=BE=E4=BC=9A=E6=98=93=E5=A7=90QwQ?=
<45892418+SocialSisterYi@users.noreply.github.com>
Date: Fri, 8 May 2020 18:32:38 +0800
Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E5=96=84=E5=8E=86=E5=8F=B2=E8=AE=B0?=
=?UTF-8?q?=E5=BD=95=E6=96=87=E6=A1=A3=20=E6=B7=BB=E5=8A=A0=E6=B8=85?=
=?UTF-8?q?=E7=A9=BA=20=E5=88=A0=E9=99=A4=20=E5=81=9C=E7=94=A8=E7=9B=B8?=
=?UTF-8?q?=E5=85=B3=20=E5=B9=B6=E5=8B=98=E8=AF=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 2 +-
electric/Bcoin.md | 2 +-
electric/WeChat&Alipay.md | 2 +-
electric/charge_msg.md | 2 +-
history&toview/play_history.md | 166 ++++++++++++++++++++++++++++++---
5 files changed, 155 insertions(+), 19 deletions(-)
diff --git a/README.md b/README.md
index e7413dc..3113b28 100644
--- a/README.md
+++ b/README.md
@@ -90,7 +90,7 @@
- 小视频
- 操作
- [历史记录&稍后再看](history&toview)
- - [历史记录](history&toview/play_history.md)×
+ - [历史记录](history&toview/play_history.md)√
- 稍后再看
- 收藏夹
- 课程
diff --git a/electric/Bcoin.md b/electric/Bcoin.md
index 7b8371e..6ed0954 100644
--- a/electric/Bcoin.md
+++ b/electric/Bcoin.md
@@ -26,7 +26,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功（并不代表充电成功）
-400：请求错误
-111：csrf校验失败
-101：账号未登录 |
+| code | num | 返回值 | 0：成功（并不代表充电成功）
-101：账号未登录
-111：csrf校验失败
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |
diff --git a/electric/WeChat&Alipay.md b/electric/WeChat&Alipay.md
index 0c244cc..582bf31 100644
--- a/electric/WeChat&Alipay.md
+++ b/electric/WeChat&Alipay.md
@@ -39,7 +39,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-400：请求错误
-500：服务器错误
-111：csrf校验失败
-101：账号未登录 |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-500：服务器错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |
diff --git a/electric/charge_msg.md b/electric/charge_msg.md
index f3e1ef6..14ed196 100644
--- a/electric/charge_msg.md
+++ b/electric/charge_msg.md
@@ -20,7 +20,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-400：请求错误
-111：csrf校验失败
-101：账号未登录
88203：不能重复留言 |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
88203：不能重复留言 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
diff --git a/history&toview/play_history.md b/history&toview/play_history.md
index c73ed04..9db8a4a 100644
--- a/history&toview/play_history.md
+++ b/history&toview/play_history.md
@@ -10,10 +10,10 @@
**参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | --------- |
-| pn | url | 页码 | 非必要 | 默认为1 |
-| ps | url | 每页项数 | 非必要 | 默认为100 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------ | ------- |
+| pn | url | 页码 | 非必要 | 默认为1 |
+| ps | url | 每页项数 | 非必要 | |
**json回复：**
@@ -63,7 +63,7 @@
| 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信息 | |
+| page | obj | 最后观看的分P信息 | |
| count | num | 分P数 | 非投稿视频无此项 |
| progress | num | 观看进度 | 单位为秒 |
| view_at | num | 观看时间 | 时间戳 |
@@ -114,15 +114,7 @@
| dislike | num | 0 | 作用尚不明确 |
| evaluation | str | 视频评分 | 默认为空 |
-`data`数组中的对象中的`pages`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | ---------- | ------------- |
-| 0 | obj | 1P内容 | 无分P仅有此项 |
-| n | obj | (n+1)P内容 | |
-| …… | obj | …… | …… |
-
-`pages`数组中的对象：
+`pages`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | ------------------------------------ |
@@ -135,7 +127,7 @@
| weblink | str | 空 | 作用尚不明确 |
| dimension | obj | 当前分P分辨率 | |
-`pages`数组中的对象中的`dimension`对象(同`data`数组中的对象中的`dimension`对象)：
+`pages`中的`dimension`对象(同`data`数组中的对象中的`dimension`对象)：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ------------ |
@@ -371,3 +363,147 @@ http://api.bilibili.com/x/v2/history?ps=5&pn=1
}
```
+
+
+## 删除视频观看历史记录
+
+> http://api.bilibili.com/x/v2/history/delete
+
+*方式：POST*
+
+需要登录(SESSDATA)
+
+**参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------ | ------------------------ |
+| kid | data | 删除的目标记录 | 必要 | 格式：archive_{视频avID} |
+| csrf | data | 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"
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+
+
+## 清空历史记录
+
+> http://api.bilibili.com/x/v2/history/clear
+
+*方式：POST*
+
+需要登录(SESSDATA)
+
+**参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------ | ---- |
+| csrf | data | 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"
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+
+
+## 停用历史记录
+
+> http://api.bilibili.com/x/v2/history/shadow/set
+
+*方式：POST*
+
+需要登录(SESSDATA)
+
+该功能不会影响历史记录的保存于删除
+
+**参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------ | -------------------------------------------- |
+| switch | data | 停用开关 | 非必要 | true：停用
false：正常
默认为false |
+| csrf | data | 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"
+
+```json
+{
+ "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：正常 |
\ No newline at end of file