From 7bb0a16f979f2b0c5905229a74f1777eedc3b1fe Mon Sep 17 00:00:00 2001
From: SocialSisterYi <45892418+SocialSisterYi@users.noreply.github.com>
Date: Sun, 21 Jun 2020 15:38:08 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=A7=86=E9=A2=91=E5=BF=83?=
=?UTF-8?q?=E8=B7=B3=E4=B8=8A=E6=8A=A5=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
---
cheese/videostream_url.md | 2 +-
danmaku/action.md | 28 +++++++++----------
electric/charge_list.md | 10 +++----
history&toview/history.md | 2 +-
history&toview/toview.md | 10 +++----
user/space.md | 34 +++++++++++------------
video/info.md | 24 ++++++++---------
video/like_coin_fav.md | 52 +++++++++++++++++------------------
video/pbp.md | 6 ++---
video/recommend.md | 8 +++---
video/report.md | 57 +++++++++++++++++++++++++++++++++++++--
video/snapshot.md | 12 ++++-----
video/status_number.md | 8 +++---
video/tags.md | 8 +++---
video/videostream_url.md | 12 ++++-----
15 files changed, 163 insertions(+), 110 deletions(-)
diff --git a/cheese/videostream_url.md b/cheese/videostream_url.md
index 5628b9a..415881a 100644
--- a/cheese/videostream_url.md
+++ b/cheese/videostream_url.md
@@ -22,7 +22,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
-| aid | num | 课程avID | 必要 | |
+| avid | num | 课程avID | 必要 | |
| ep_id | num | 课程epID | 必要 | |
| cid | num | 视频CID | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32（480P）
登录默认64（720P）
**值含义见下表** |
diff --git a/danmaku/action.md b/danmaku/action.md
index b8949bf..dd37ce4 100644
--- a/danmaku/action.md
+++ b/danmaku/action.md
@@ -10,20 +10,20 @@
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| -------- | ---- | ---------------------- | ------ | ------------------------------------------------------------ |
-| type | num | 1 | 必要 | |
-| oid | num | 视频CID | 必要 | |
-| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒
默认为0 |
-| color | num | 弹幕颜色设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)
默认为16777215（#FFFFFF）白色 |
-| fontsize | num | 弹幕字号设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)
默认为25 |
-| pool | num | 弹幕池选择 | 非必要 | 0：普通弹幕
1：字幕弹幕
2：BAS弹幕
默认为0 |
-| mode | num | 弹幕类型选择 | 必要 | 1：普通
4：底部
5：顶部
7：高级
9：BAS（`pool`必须为2） |
-| rnd | num | 16位10进制随机数 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**
若有此项，则发送弹幕冷却时间限制为5s |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ---------------------- | ------------ | ------------------------------------------------------------ |
+| type | num | 1 | 必要 | |
+| oid | num | 视频CID | 必要 | |
+| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒
默认为0 |
+| color | num | 弹幕颜色设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)
默认为16777215（#FFFFFF）白色 |
+| fontsize | num | 弹幕字号设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)
默认为25 |
+| pool | num | 弹幕池选择 | 非必要 | 0：普通弹幕
1：字幕弹幕
2：BAS弹幕
默认为0 |
+| mode | num | 弹幕类型选择 | 必要 | 1：普通
4：底部
5：顶部
7：高级
9：BAS（`pool`必须为2） |
+| rnd | num | 16位10进制随机数 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**
若有此项，则发送弹幕冷却时间限制为5s |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
diff --git a/electric/charge_list.md b/electric/charge_list.md
index 0cc2f36..e65d373 100644
--- a/electric/charge_list.md
+++ b/electric/charge_list.md
@@ -139,11 +139,11 @@
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------ | ------ | ------------------ |
-| mid | num | 目标用户UID | 必要 | |
-| aid | num | 目标视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 目标视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------ | ------------ | ------------------ |
+| mid | num | 目标用户UID | 必要 | |
+| aid | num | 目标视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 目标视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
diff --git a/history&toview/history.md b/history&toview/history.md
index 7978085..de089a6 100644
--- a/history&toview/history.md
+++ b/history&toview/history.md
@@ -62,7 +62,7 @@
| bangumi | obj | 番剧/影视信息 | 非番剧/影视无此项 |
| cheese | obj | 课程信息 | 非课程无此项 |
| favorite | bool | 是否已收藏 | true：已收藏
false：未收藏 |
-| type | num | 视频属性 | 3：普通视频
4：番剧/影视
10：课程 |
+| 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信息 | |
diff --git a/history&toview/toview.md b/history&toview/toview.md
index 79b09fa..c15d36c 100644
--- a/history&toview/toview.md
+++ b/history&toview/toview.md
@@ -14,11 +14,11 @@
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
diff --git a/user/space.md b/user/space.md
index e359792..55a6f55 100644
--- a/user/space.md
+++ b/user/space.md
@@ -2322,12 +2322,12 @@ curl -b "SESSDATA=xxx;DedeUserID=1" -d "csrf=xxx&tags=minecraft%2C%E6%8A%80%E6%9
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------- | ------ | ------------------ |
-| aid | num | 置顶目标视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 置顶目标视频bvID | 非必要 | avID与bvID任选一个 |
-| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符 |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------------ | -------------------------------- |
+| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
+| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符
默认为空 |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
@@ -2407,12 +2407,12 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/space/top/arc/ca
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------- | ------ | ------------------ |
-| aid | num | 置顶目标视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 置顶目标视频bvID | 非必要 | avID与bvID任选一个 |
-| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符 |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------------ | -------------------------------- |
+| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
+| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符
默认为空 |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
@@ -2452,11 +2452,11 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=94916552" "http://api.bilibili.com/x/spa
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------------------- | ------ | ------------------ |
-| aid | num | 要删除的目标视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 要删除的目标视频bvID | 非必要 | avID与bvID任选一个 |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------------------- | ------------ | ------------------ |
+| aid | num | 要删除的目标视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 要删除的目标视频bvID | 必要（可选） | avID与bvID任选一个 |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
diff --git a/video/info.md b/video/info.md
index a82bc31..12ed153 100644
--- a/video/info.md
+++ b/video/info.md
@@ -10,10 +10,10 @@
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
@@ -357,10 +357,10 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
@@ -400,10 +400,10 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
diff --git a/video/like_coin_fav.md b/video/like_coin_fav.md
index 8ef3740..d1ff982 100644
--- a/video/like_coin_fav.md
+++ b/video/like_coin_fav.md
@@ -14,12 +14,12 @@
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------- | ------ | ---------------------- |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
-| like | num | 操作方式 | 必要 | 1：点赞
2：取消赞 |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------------ | ---------------------- |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| like | num | 操作方式 | 必要 | 1：点赞
2：取消赞 |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
@@ -59,13 +59,13 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ----------- | ---- | ------------------- | ------ | --------------------------------------- |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
-| select_like | num | 附加点赞 | 非必要 | 0：不点赞
1：同时点赞
默认为0 |
-| multiply | num | 投币数量 | 必要 | 上限为2 |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------- | ------------ | --------------------------------------- |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| select_like | num | 附加点赞 | 非必要 | 0：不点赞
1：同时点赞
默认为0 |
+| multiply | num | 投币数量 | 必要 | 上限为2 |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
@@ -171,11 +171,11 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
-| csrf | str | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| csrf | str | cookies中的bili_jct | 必要 | |
**json回复：**
@@ -287,10 +287,10 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
@@ -332,10 +332,10 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
diff --git a/video/pbp.md b/video/pbp.md
index 98b3cf5..20d5340 100644
--- a/video/pbp.md
+++ b/video/pbp.md
@@ -12,9 +12,9 @@
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----- | ------ | ---- |
-| vid | num | 视CID | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------- | ------ | ---- |
+| vid | num | 视频CID | 必要 | |
**json回复：**
diff --git a/video/recommend.md b/video/recommend.md
index 4a8e693..ac7ff66 100644
--- a/video/recommend.md
+++ b/video/recommend.md
@@ -10,10 +10,10 @@
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
diff --git a/video/report.md b/video/report.md
index 386b367..6440f26 100644
--- a/video/report.md
+++ b/video/report.md
@@ -19,8 +19,6 @@
**json回复：**
-**json回复：**
-
根对象：
| 字段 | 类型 | 内容 | 备注 |
@@ -43,3 +41,58 @@ curl -b "SESSDATA=xxx" -d "aid=13662970&cid=126654047&progress=1248&csrf=xxx" "h
}
```
+
+
+## 上报视频播放心跳（web端）
+
+> http://api.bilibili.com/x/click-interface/web/heartbeat
+
+*方式：POST*
+
+默认间隔15秒一次
+
+亦可记录播放历史
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------- | ------------ | ------------------------------------------------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| cid | num | 视频CID | 非必要 | 用于识别分P |
+| epid | num | 番剧epID | 非必要 | |
+| sid | num | 番剧ssID | 非必要 | |
+| mid | num | 当前用户UID | 非必要 | |
+| played_time | num | 视频播放进度 | 非必要 | 单位为秒
默认为0 |
+| realtime | num | 总计播放时间 | 非必要 | 单位为秒 |
+| start_ts | num | 开始播放时刻 | 非必要 | 时间戳 |
+| type | num | 视频类型 | 非必要 | 3：投稿视频
4：剧集
10：课程 |
+| sub_type | num | 剧集副类型 | 非必要 | 当`type=4`时本参数有效
1：番剧
2：电影
3：纪录片
4：国创
5：电视剧
7：综艺 |
+| dt | num | 2 | 非必要 | |
+| play_type | num | 播放动作 | 非必要 | 0：播放中
1：开始播放
2：暂停
3：继续播放 |
+| csrf | str | cookies中的bili_jct | 非必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | 作用尚不明确 |
+
+**示例：**
+
+上报一次视频`av2`/`BV1xx411c7mD`的心跳数据
+
+ http://api.bilibili.com/x/click-interface/web/heartbeat?aid=2&bvid=BV1xx411c7mD&cid=62131&played_time=60&realtime=60&start_ts=1592720840&type=3&dt=2&play_type=0&csrf=xxx
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
diff --git a/video/snapshot.md b/video/snapshot.md
index 6ab7add..4f9bd26 100644
--- a/video/snapshot.md
+++ b/video/snapshot.md
@@ -13,12 +13,12 @@
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------ | ------ | ----------------------------------- |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
-| cid | num | 分P CID | 非必要 | 默认为1P |
-| index | num | json数组截取时间表 | 非必要 | 1：需要
0：不需要
默认为0 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------ | ------------ | ----------------------------------- |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| cid | num | 分P CID | 非必要 | 默认为1P |
+| index | num | json数组截取时间表 | 非必要 | 1：需要
0：不需要
默认为0 |
**json回复：**
diff --git a/video/status_number.md b/video/status_number.md
index 5ebd740..6af8fcd 100644
--- a/video/status_number.md
+++ b/video/status_number.md
@@ -85,10 +85,10 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
diff --git a/video/tags.md b/video/tags.md
index 04fee9d..e2c732d 100644
--- a/video/tags.md
+++ b/video/tags.md
@@ -8,10 +8,10 @@
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------ | ------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
**json回复：**
diff --git a/video/videostream_url.md b/video/videostream_url.md
index 5cfe45b..e1b48fd 100644
--- a/video/videostream_url.md
+++ b/video/videostream_url.md
@@ -20,12 +20,12 @@
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
-| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
-| cid | num | 视频CID | 必要 | |
-| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32（480P）
登录默认64（720P）
**值含义见下表** |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------------- | ------------ | ------------------------------------------------------------ |
+| avid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| cid | num | 视频CID | 必要 | |
+| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32（480P）
登录默认64（720P）
**值含义见下表** |
分辨率代码：