diff --git a/README.md b/README.md
index 2010db8..8714bab 100644
--- a/README.md
+++ b/README.md
@@ -34,10 +34,10 @@
- [API认证与鉴权（APP与Cookie方式）](other/API_auth.md)×
- [图片格式化](other/picture.md)√
- [登录](login)
- - [登录操作](login/login_action)√
- + [短信登录](login/verify/SMS.md)√
- + [密码登录](login/verify/password.md)√
- + [二维码登录](login/QR.md)√
+ - [登录操作（人机认证）](login/login_action)√
+ + [短信登录](llogin/login_action/SMS.md)√
+ + [密码登录](login/login_action/password.md)√
+ + [二维码登录](login/login_action/QR.md)√
+ SNS登录（QQ&微博）
- [登录基本信息](login/login_info.md)√
- [个人中心](login/member_center.md)×
@@ -109,8 +109,7 @@
- [统计与数据](creativecenter/statistics&data.md)x
- 列表查询相关
- [电磁力数据](creativecenter/railgun.md)√
-- [实时广播](broadcast)
- - [总则](broadcast/general.md)√
+- [实时广播（通讯协议）](broadcast)√
- [视频内广播](broadcast/video_room.md)√
- [充电](electric)
- [B币方式](electric/Bcoin.md)√
@@ -173,9 +172,7 @@ B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/rea
不了解json的请移步，[传送门](https://www.sojson.com/json/json_index.html)
-
-
-**相关项目**：
+# 相关项目：
库及文档：
@@ -189,7 +186,7 @@ https://github.com/Vespa314/bilibili-api
https://github.com/Hsury/Bilibili-Toolkit
- https://github.com/adachi-sakura/openbilibili-go-common-1
+https://github.com/whjstc/openbilibili-go-common-1
成品：
diff --git a/article/info.md b/article/info.md
index c242d1a..9c62ccb 100644
--- a/article/info.md
+++ b/article/info.md
@@ -20,7 +20,7 @@
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此信息 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/article/like_coin_fav.md b/article/like_coin_fav.md
index 0e8d19b..7e8b0c0 100644
--- a/article/like_coin_fav.md
+++ b/article/like_coin_fav.md
@@ -26,7 +26,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
65006：已赞过
65004：取消点赞失败 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -68,7 +68,7 @@ curl -b "SESSDATA=xxx" -d "id=5806746&type=1&csrf=xxx" "http://api.bilibili.com/
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-104：硬币不足
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
34002：不能给自己投币
34003：非法的投币数量
34005：超过投币上限 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
diff --git a/blackroom/banlist.md b/blackroom/banlist.md
index dcff653..3e19ce8 100644
--- a/blackroom/banlist.md
+++ b/blackroom/banlist.md
@@ -4,30 +4,39 @@
| 代码 | 含义 |
| ---- | -------------------- |
+| 1 | 刷屏 |
+| 2 | 抢楼 |
+| 3 | 发布色情低俗信息 |
| 4 | 发布赌博诈骗信息 |
| 5 | 发布违禁相关信息 |
| 6 | 发布垃圾广告信息 |
| 7 | 发布人身攻击言论 |
| 8 | 发布侵犯他人隐私信息 |
| 9 | 发布引战言论 |
+| 10 | 发布剧透信息 |
| 11 | 恶意添加无关标签 |
| 12 | 恶意删除他人标签 |
| 13 | 发布色情信息 |
| 14 | 发布低俗信息 |
| 15 | 发布暴力血腥信息 |
| 16 | 涉及恶意投稿行为 |
+| 17 | 发布非法网站信息 |
| 18 | 发布传播不实信息 |
| 19 | 发布怂恿教唆信息 |
+| 20 | 恶意刷屏 |
| 21 | 账号违规 |
+| 22 | 恶意抄袭 |
| 23 | 冒充自制原创 |
| 24 | 发布青少年不良内容 |
+| 25 | 破坏网络安全 |
| 26 | 发布虚假误导信息 |
| 27 | 仿冒官方认证账号 |
+| 28 | 发布不适宜内容 |
+| 29 | 违反运营规则 |
+| 30 | 恶意创建话题 |
| 31 | 发布违规抽奖 |
| 32 | 恶意冒充他人 |
-
-
## 获取封禁用户公示列表
> http://api.bilibili.com/x/credit/blocked/list
@@ -52,7 +61,7 @@
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 公示列表 | |
`data`数组：
@@ -184,7 +193,7 @@ http://api.bilibili.com/x/credit/blocked/list?btype=&otype=0&pn=1
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此信息 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/broadcast/general.md b/broadcast/readme.md
similarity index 97%
rename from broadcast/general.md
rename to broadcast/readme.md
index 5bd709d..5bfcf39 100644
--- a/broadcast/general.md
+++ b/broadcast/readme.md
@@ -1,5 +1,9 @@
# 全站广播
+可用的广播服务：
+
+- [视频实时信息](video_room.md)√
+
## 获取广播服务器地址
> http://api.bilibili.com/x/web-interface/broadcast/servers
@@ -20,7 +24,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -109,8 +113,6 @@
}
```
-
-
## 服务器数据包
连接服务器分为三种方式，分别是ws wss tcp，数据包分为上行和下行
diff --git a/broadcast/video_room.md b/broadcast/video_room.md
index 5fd8ccd..1b0f890 100644
--- a/broadcast/video_room.md
+++ b/broadcast/video_room.md
@@ -31,8 +31,6 @@
00000050 30 30 30 5d 7d |000]}|
```
-
-
## 认证包回复（下行）
**正文内容json：**
@@ -54,8 +52,6 @@
00000030 69 6f 6e 22 3a 31 7d |ion":1}|
```
-
-
## 心跳包（上行）
正文可为任意内容或为空
@@ -77,8 +73,6 @@
00000020 5d |]|
```
-
-
## 心跳包回复（实时观看数）（下行）
**正文内容json：**
@@ -118,8 +112,6 @@
00000060 34 37 32 33 22 7d 7d 7d |4723"}}}|
```
-
-
## 普通包（实时弹幕）（下行）
**正文内容json：**
diff --git a/cheese/videostream_url.md b/cheese/videostream_url.md
index bcd9c6a..61cc9ea 100644
--- a/cheese/videostream_url.md
+++ b/cheese/videostream_url.md
@@ -236,7 +236,7 @@ curl -G 'http://api.bilibili.com/pugv/player/web/playurl'\
将`data`.`durl`.`[1-n]`.`url`或`data`.`durl`.`[1-n]`.`backup_url`.`[0]`中的内容作为url进行GET操作, 如果有多个视频, 需要手动合并处理
-需要验证Header中`referer`在 `http://www.bilibili.com`或`https://www.bilibili.com`域名下
+需要验证请求Header中`referer`为 `.bilibili.com`域名下（防盗链）
**无referer或错误的情况会返回403 Forbidden**故无法获取
diff --git a/comment/action.md b/comment/action.md
index 4a8bd47..755b10f 100644
--- a/comment/action.md
+++ b/comment/action.md
@@ -28,9 +28,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-509：请求过于频繁
12002：评论区已关闭
12006：没有该评论
12009：评论主体的type不合法
12015：需要评论验证码
12016：评论内容包含敏感信息
12025：评论字数过多
12035：该账号被UP主列入评论黑名单
12051：重复评论，请勿刷屏
**（其他错误码有待补充）** |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-509：请求过于频繁
12001：已经存在评论主题
12002：评论区已关闭
12003：禁止回复
12006：没有该评论
12009：评论主体的type不合法
12015：需要评论验证码
12016：评论内容包含敏感信息
12025：评论字数过多
12035：该账号被UP主列入评论黑名单
12051：重复评论，请勿刷屏
**（其他错误码有待补充）** |
| message | str | 错误信息 |
|
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 数据本体 | |
`data`对象：
@@ -238,9 +238,9 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&message=%E6%B5%8B%E8%AF%95test%5
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-509：请求过于频繁
12002：评论区已关闭
12006：没有该评论
12009：评论主体的type不合法
12011：不合法的赞或踩
**（其他错误码有待补充）** |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-509：请求过于频繁
12002：评论区已关闭
12004：禁止操作 赞或踩
12006：没有该评论
12009：评论主体的type不合法
12011：不合法的赞或踩
**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
**示例：**
@@ -282,9 +282,9 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-509：请求过于频繁
12002：评论区已关闭
12006：没有该评论
12009：评论主体的type不合法
12011：不合法的赞或踩
**（其他错误码有待补充）** |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-509：请求过于频繁
12002：评论区已关闭
12004：禁止操作 赞或踩
12006：没有该评论
12009：评论主体的type不合法
12011：不合法的赞或踩
**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
**示例：**
@@ -371,7 +371,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&csrf=xxx" "http:
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-403：权限不足
-404：无此项
-509：请求过于频繁
12002：评论区已关闭
12006：没有该评论
12009：评论主体的type不合法
12029：已经有置顶评论
12030：不能置顶非一级评论
**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
**示例：**
@@ -397,14 +397,16 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=2940645593&action=1&csrf=xx
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
-| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
-| oid | num | 目标评论区ID | 必要 | |
-| rpid | num | 目标评论rpID | 必要 | |
-| reason | num | 举报类型 | 必要 | 0：自定义备注
1：垃圾广告
2：色情
4：引战
5：剧透
7：人身攻击
8：内容不相关
9：违法违规
10：低俗
12：赌博诈骗
15：侵犯隐私
16：抢楼
17：青少年不良信息 |
-| content | str | 自定义举报备注 | 非必要 | `reason=0`时有效 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------- | ---- | ------------------------ | ------ | ----------------------------------------------- |
+| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
+| oid | num | 目标评论区ID | 必要 | |
+| rpid | num | 目标评论rpID | 必要 | |
+| reason | num | 举报类型 | 必要 | **类型代码见下表** |
+| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+举报类型`reason`：
**json回复：**
@@ -414,7 +416,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=2940645593&action=1&csrf=xx
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-403：权限不足
-404：无此项
-509：请求过于频繁
12002：评论区已关闭
12006：没有该评论
12008：已经举报过了
12009：评论主体的type不合法
12019：举报过于频繁
**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
**示例：**
diff --git a/comment/comment_list.md b/comment/comment_list.md
index 49cd341..b08496f 100644
--- a/comment/comment_list.md
+++ b/comment/comment_list.md
@@ -1,4 +1,4 @@
-# 评论区明细
+# 点评评论区明细
@@ -6,17 +6,26 @@
| 代码 | 评论区类型 | oid的意义 |
| ---- | ----------------------- | ---------- |
-| 1 | 视频 | 视频avID |
+| 1 | 视频稿件 | 视频avID |
| 2 | 话题 | 话题ID |
| 4 | 活动 | 活动ID |
| 5 | 小视频 | 小视频ID |
-| 6 | 小黑屋 | 封禁公示ID |
-| 8 | 直播 | 直播间ID |
-| 11 | 相簿&画友（图片动态） | 相簿ID |
+| 6 | 小黑屋封禁信息 | 封禁公示ID |
+| 7 | 公告信息 | 公告ID |
+| 8 | 直播活动 | 直播间ID |
+| 9 | 活动稿件 | |
+| 10 | 直播公告 | |
+| 11 | 相簿（图片动态） | 相簿ID |
| 12 | 专栏 | 专栏cvID |
+| 13 | 票务 | |
| 14 | 音频 | 音频auID |
| 15 | 风纪委员会 | 众裁项目ID |
+| 16 | 点评 | |
| 17 | 动态（纯文字动态&分享） | 动态ID |
+| 18 | 播单 | |
+| 19 | 音乐播单 | |
+| 20 | 漫画 | |
+| 21 | 漫画 | |
| 22 | 漫画 | 漫画mcID |
| 33 | 课程 | 课程epID |
@@ -45,7 +54,7 @@
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此项
12002：评论区已关闭
12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | 正确时：obj
错误时：null | 数据本体 | |
`data`对象：
@@ -2348,7 +2357,7 @@
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此项
12002：评论区已关闭
12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | 正确时：obj
错误时：null | 数据本体 | |
`data`对象：
@@ -4716,7 +4725,7 @@ http://api.bilibili.com/x/v2/reply/main?type=1&oid=2&mode=3&next=0&ps=5
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此项
12002：评论区已关闭
12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | 正确时：obj
错误时：null | 数据本体 | |
`data`对象：
@@ -5438,7 +5447,7 @@ http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此项
12002：评论区已关闭
12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | 正确时：obj
错误时：null | 数据本体 | |
`data`对象：
@@ -6153,8 +6162,6 @@ http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5
}
```
-
-
## 获取指定评论对话树（APP端）（带有楼层）
> http://api.bilibili.com/x/v2/reply/dialog/cursor
@@ -6175,7 +6182,16 @@ http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5
**json回复：**
-data`对象：
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此项
12002：评论区已关闭
12009：评论主体的type不合法 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | 正确时：obj
错误时：null | 数据本体 | |
+
+`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | -------------- | ---------------- |
@@ -7003,8 +7019,6 @@ data`对象：
}
```
-
-
## 获取评论区评论总数（APP端）
> http://api.bilibili.com/x/v2/reply/count
@@ -7026,7 +7040,7 @@ data`对象：
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此项
12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | 正确时：obj
错误时：null | 数据本体 | |
`data`对象：
@@ -7053,8 +7067,6 @@ http://api.bilibili.com/x/v2/reply/count?type=1&oid=2
```
-
-
## 附表-评论条目对象
| 字段 | 类型 | 内容 | 备注 |
diff --git a/creativecenter/railgun.md b/creativecenter/railgun.md
index efd380c..fdd1909 100644
--- a/creativecenter/railgun.md
+++ b/creativecenter/railgun.md
@@ -18,7 +18,7 @@
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -62,7 +62,7 @@ http://member.bilibili.com/x/web/elec/user
| ------- | ---- | ------- | ----------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -153,7 +153,7 @@ http://api.bilibili.com/studio/up-rating/rating/summary
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/danmaku/action.md b/danmaku/action.md
index 6d94eab..e4b962d 100644
--- a/danmaku/action.md
+++ b/danmaku/action.md
@@ -31,9 +31,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
36702：弹幕长度大于100
36703：发送频率过快
36709：您的等级不足，不能发送高级弹幕
36710：您的权限不足，不能发送这种样式的弹幕
36711：该视频禁止发送弹幕
36714：弹幕出现时刻超过视频总时长
**（其他错误码有待补充）** |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
36700：系统升级中
36701：弹幕包含被禁止的内容
36702：弹幕长度大于100
36703：发送频率过快
36704：禁止向未审核的视频发送弹幕
36705：您的等级不足，不能发送弹幕
36706：您的等级不足，不能发送顶端弹幕
36707：您的等级不足，不能发送底端弹幕
36708：您的等级不足，不能发送彩色弹幕
36709：您的等级不足，不能发送高级弹幕
36710：您的权限不足，不能发送这种样式的弹幕
36711：该视频禁止发送弹幕
36712：level 1用户发送弹幕的最大长度为20
36713：稿件未付费
36714：弹幕发送时间不合法
36715：当日操作数量超过上限 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -93,9 +93,9 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=62131&msg=%e5%89%8d%e6%9d%a5%e8%80%83%e5%8
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
36301：撤回失败，弹幕发送已过2分钟
36302：撤回失败，弹幕已经被删除或撤回
36303：撤回失败，今天撤回的机会已经用完
**（其他错误码有待补充）** |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
36301：撤回失败，弹幕发送已过2分钟
36302：撤回失败，弹幕已经被删除或撤回
36303：撤回失败，今天撤回的机会已经用完
36304：撤回失败，服务器出错 |
| message | str | 错误信息 | 成功后显示剩余次数 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -136,9 +136,9 @@ curl -b "SESSDATA=xxx" -d "dmid=32310301474947077&cid=168901231&csrf=xxx" "http:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-107：硬币不足
-400：请求错误
36010：已购买 |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-107：硬币不足
-400：请求错误
36007：不允许购买
36009：正在确认中
36010：已购买 |
| message | str | 返回信息 | |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
示例：
@@ -178,7 +178,7 @@ curl -b "SESSDATA=xxx" -d "mode=sp&cid=168901231&csrf=xxx" "http://api.bilibili.
| ------- | ----------------------------- | ---------------- | -------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
--400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | 有效时：obj
无效时：null | 有效时：信息本体 | |
`data`对象：
@@ -187,7 +187,7 @@ curl -b "SESSDATA=xxx" -d "mode=sp&cid=168901231&csrf=xxx" "http://api.bilibili.
| ------- | ---- | ---------------- | ------------------------------------------ |
| coins | num | 需要支付的硬币数 | |
| confirm | num | 是否同意 | 1：同意
2：未同意
未购买时无此项 |
-| accept | bool | 是否允许申请 | |
+| accept | bool | 是否允许申请 | true：允许
false：不允许 |
| hasBuy | bool | 是否已购买 | true：已购买
未购买时无此项 |
**示例：**
diff --git a/danmaku/history.md b/danmaku/history.md
index 5793fe9..8c27669 100644
--- a/danmaku/history.md
+++ b/danmaku/history.md
@@ -24,7 +24,7 @@
| ------- | ------------------------------- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | 有弹幕：array
无弹幕：null | 日期列表 | |
`data`数组：
diff --git a/danmaku/snapshot.md b/danmaku/snapshot.md
index 7e22ae0..3303451 100644
--- a/danmaku/snapshot.md
+++ b/danmaku/snapshot.md
@@ -22,7 +22,7 @@
| ------- | ----- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 预览列表 | |
`data`数组：
diff --git a/electric/Bcoin.md b/electric/Bcoin.md
index ebcf9d3..a8bd34a 100644
--- a/electric/Bcoin.md
+++ b/electric/Bcoin.md
@@ -28,7 +28,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功（并不代表充电成功）
-101：账号未登录
-111：csrf校验失败
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/electric/WeChat&Alipay.md b/electric/WeChat&Alipay.md
index 4b155d8..901091a 100644
--- a/electric/WeChat&Alipay.md
+++ b/electric/WeChat&Alipay.md
@@ -41,7 +41,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-500：服务器错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -93,7 +93,7 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/electric/charge_list.md b/electric/charge_list.md
index 8b4bf9b..1066c26 100644
--- a/electric/charge_list.md
+++ b/electric/charge_list.md
@@ -153,7 +153,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频
62001：不需要展示充电信息 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/electric/charge_msg.md b/electric/charge_msg.md
index 2672f68..ead97eb 100644
--- a/electric/charge_msg.md
+++ b/electric/charge_msg.md
@@ -22,7 +22,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
88203：不能重复留言 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
diff --git a/emote/action.md b/emote/action.md
index e63f4ff..c7f568c 100644
--- a/emote/action.md
+++ b/emote/action.md
@@ -26,7 +26,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-403：访问权限不足 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
**示例：**
@@ -66,7 +66,7 @@ curl -b "SESSDATA=xxx" -d "package_id=25&business=reply&csrf=xxx" "http://api.bi
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-403：访问权限不足 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
**示例：**
diff --git a/emote/emote_list.md b/emote/emote_list.md
index b3ed6c5..495cf9a 100644
--- a/emote/emote_list.md
+++ b/emote/emote_list.md
@@ -22,7 +22,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -228,7 +228,7 @@
| ------- | ----------------------------- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | 有效时：obj
无效时：null | 信息本体 | |
`data`对象：
@@ -515,7 +515,7 @@
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/history&toview/history.md b/history&toview/history.md
index dbec1a7..d159681 100644
--- a/history&toview/history.md
+++ b/history&toview/history.md
@@ -27,7 +27,7 @@
| ------- | ----- | ------------ | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | array | 历史记录列表 | |
`data`对象：
@@ -356,7 +356,7 @@
| ------- | ------ | ------------ | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | array | 历史记录列表 | |
`data`数组：
@@ -719,7 +719,7 @@ http://api.bilibili.com/x/v2/history?ps=5&pn=1
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -757,7 +757,7 @@ curl -b "SESSDATA=xxx" -d "kid=archive_540580868&csrf=xxx" "http://api.bilibili.
| ------- | ---- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -798,7 +798,7 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/v2/history/clear
| ------- | ---- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -830,7 +830,7 @@ curl -b "SESSDATA=xxx" -d "switch=true&csrf=xxx" "http://api.bilibili.com/x/v2/h
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | bool | 停用状态 | true：停用
false：正常 |
**示例：**
diff --git a/history&toview/toview.md b/history&toview/toview.md
index 81a34bd..8f509de 100644
--- a/history&toview/toview.md
+++ b/history&toview/toview.md
@@ -28,7 +28,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
90001：列表已满
90003：稿件已经被删除 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -112,7 +112,7 @@ curl --referer "http://.bilibili.com" -b "SESSDATA=xxx;DedeUserID=1;DedeUserID__
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | data | 数据本体 | |
`data`对象：
@@ -398,7 +398,7 @@ http://api.bilibili.com/x/v2/history/toview
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -450,7 +450,7 @@ curl -b "SESSDATA=xxx" -d "viewed=true&csrf=xxx" "http://api.bilibili.com/x/v2/h
| ------- | ---- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
diff --git a/imgs/home.svg b/imgs/home.svg
new file mode 100644
index 0000000..21b5eb9
--- /dev/null
+++ b/imgs/home.svg
@@ -0,0 +1,6 @@
+
\ No newline at end of file
diff --git a/imgs/bangumi_fav.svg b/imgs/sub.svg
similarity index 100%
rename from imgs/bangumi_fav.svg
rename to imgs/sub.svg
diff --git a/live/info.md b/live/info.md
index f9b9c56..ad4e38a 100644
--- a/live/info.md
+++ b/live/info.md
@@ -20,7 +20,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/live/manage.md b/live/manage.md
index 1dca523..3858185 100644
--- a/live/manage.md
+++ b/live/manage.md
@@ -58,12 +58,12 @@ curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&title=%E6%B5%8B%E8%AF%9
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| -------- | ---- | ------------------------ | ------ | ---------------------------- |
-| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID |
-| area_v2 | num | 直播分区ID（子分区ID） | 必要 | 详见[直播分区](live_area.md) |
-| platform | str | 必须为`pc` | 必要 | |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ------------------------ | ------ | ----------------------------------- |
+| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID |
+| area_v2 | num | 直播分区ID（子分区ID） | 必要 | 详见[直播分区](live_area.md) |
+| platform | str | 直播平台 | 必要 | web端：
bililink：android_link |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@@ -78,16 +78,16 @@ curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&title=%E6%B5%8B%E8%AF%9
`data`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| --------- | ------ | ---------------- | ---------------------- |
-| change | num | 是否改变状态 | 0：未改变
1：改变 |
-| status | str | LIVE | |
-| room_type | num | 0 | 作用尚不明确 |
-| rtmp | obj | RTMP推流地址信息 | |
-| protocols | srrary | ？？？ | 作用尚不明确 |
-| try_time | str | ？？？ | 作用尚不明确 |
-| live_key | str | ？？？ | 作用尚不明确 |
-| notice | obj | ？？？ | 作用尚不明确 |
+| 字段 | 类型 | 内容 | 备注 |
+| --------- | ----- | ---------------- | ---------------------- |
+| change | num | 是否改变状态 | 0：未改变
1：改变 |
+| status | str | LIVE | |
+| room_type | num | 0 | 作用尚不明确 |
+| rtmp | obj | RTMP推流地址信息 | |
+| protocols | array | ？？？ | 作用尚不明确 |
+| try_time | str | ？？？ | 作用尚不明确 |
+| live_key | str | ？？？ | 作用尚不明确 |
+| notice | obj | ？？？ | 作用尚不明确 |
`data`中的`rtmp`对象：
diff --git a/login/login_action/QR.md b/login/login_action/QR.md
index 1def912..8ad267e 100644
--- a/login/login_action/QR.md
+++ b/login/login_action/QR.md
@@ -13,7 +13,7 @@
-## 申请二维码URL及扫码密钥
+## 申请二维码URL及扫码密钥（web端）
> http://passport.bilibili.com/qrcode/getLoginUrl
@@ -59,7 +59,7 @@ curl 'http://passport.bilibili.com/qrcode/getLoginUrl'
}
```
-## 使用扫码登录（验证扫码状态）
+## 使用扫码登录（web端）
> http://passport.bilibili.com/qrcode/getLoginInfo
@@ -177,3 +177,44 @@ bili_jct=(csrf)&
gourl=(跳转网址 默认为主页)
+
+
+## 申请二维码URL及扫码密钥（TV端）
+
+> http://passport.bilibili.com/x/passport-tv-login/qrcode/auth_code
+
+*请求方式：POST*
+
+鉴权方式：appkey
+
+密钥超时为180秒
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ---------- | ----------- | ----- |
+| appkey | str | APP密钥 | APP方式必要 | |
+| local_id | str | TV端ID | APP方式必要 | 可为0 |
+| ts | num | 当前时间戳 | APP方式必要 | |
+| sign | str | APP签名 | APP方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------- |
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | ------------- | ---------- |
+| url | str | 二维码内容url | 恒为87字符 |
+| oauthKey | str | 扫码登录秘钥 | 恒为32字符 |
+
+**示例：**
+
diff --git a/login/login_action/password.md b/login/login_action/password.md
index c264f04..88bc75c 100644
--- a/login/login_action/password.md
+++ b/login/login_action/password.md
@@ -40,6 +40,8 @@ curl 'http://passport.bilibili.com/login?act=getkey'
*请求方式：POST*
+鉴权方式：appkey
+
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
diff --git a/login/member_center.md b/login/member_center.md
index b1993b3..49f510a 100644
--- a/login/member_center.md
+++ b/login/member_center.md
@@ -468,3 +468,48 @@ http://api.bilibili.com/x/member/web/coin/log
}
```
+## 修改个人签名
+
+> http://api.bilibili.com/x/member/web/sign/update
+
+*请求方式：POST*
+
+签名最多支持70个字
+
+修改签名不会立即生效，会等待审核队列稍后生效
+
+需要登录(SESSDATA)
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| --------- | ---- | ------------------------ | ------ | ---------------------- |
+| user_sign | str | 要设置的签名内容 | 非必要 | 删除签名留空或省去即可 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
40022：签名过长 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | 作用尚不明确 |
+
+**示例：**
+
+更新个人标签为`高中技术宅一枚，爱好MC&电子&音乐&数码&编程，资深猿厨`
+
+curl -b "SESSDATA=xxx" -d "user_sign=%E9%AB%98%E4%B8%AD%E6%8A%80%E6%9C%AF%E5%AE%85%E4%B8%80%E6%9E%9A%EF%BC%8C%E7%88%B1%E5%A5%BDMC&%E7%94%B5%E5%AD%90&%E9%9F%B3%E4%B9%90&%E6%95%B0%E7%A0%81&%E7%BC%96%E7%A8%8B%EF%BC%8C%E8%B5%84%E6%B7%B1%E7%8C%BF%E5%8E%A8&csrf=xxx" "http://api.bilibili.com/x/member/web/sign/update"
+
+```json
+{
+ "code":0,
+ "message":"0",
+ "ttl":1
+}
+```
+
+
+
diff --git a/other/API_auth.md b/other/API_auth.md
index b750343..777ff00 100644
--- a/other/API_auth.md
+++ b/other/API_auth.md
@@ -1,6 +1,6 @@
# API认证与鉴权
-## Cookie方式
+## Cookie方式（web端）
cookie中的值在访问登录接口成功登录时，用`set-cookie`写入
@@ -15,30 +15,36 @@ Token有效期为1月，更改密码或过期失效
| SESSDATA | 登录Token | 用于用户识别与鉴权
作用同`access_key` |
| bili_jct | CSRF Token | 用于操作性接口 |
-## APP方式
+## APP方式（手机客户端及TV端等）
| 参数 | 含义 | 备注 |
| ------------- | ---------------- | -------------- |
-| appkey | app密钥 | |
-| sign | app签名 | |
-| access_key | app登录Token | |
-| refresh_token | app刷新登录Token | 仅在刷新时使用 |
+| appkey | APP密钥 | |
+| ts | 当前时间戳 | |
+| sign | APP签名 | |
+| access_key | APP登录Token | |
+| refresh_token | APP刷新登录Token | 仅在刷新时使用 |
**接口鉴权：**
使用`appkey`作为api的必要参数，并使用除`sign`外所有参数的url字串后连接相对应的盐值进行**md5校验**（32位小写），把计算结果作为sign的值，与前面参数一同发送
-**appkey与sign盐值一一对应**
+**appkey与appsec一一对应**
已知的appkey与签名：
-| appkey | sign盐值 |
-| ---------------- | -------------------------------- |
-| 1d8b6e7d45233436 | 560c52ccd288fed045859ed18bffd973 |
-| bb3101000e232e27 | 36efcfed79309338ced0380abd824ac1 |
-| 07da50c9a0bf829f | 75d35aa5c06fb46e40059a6a5bf671a6 |
-| 4409e2ce8ffd12b8 | 59b43e04ad6965f34319062b478f83dd |
-| 37207f2beaebf8d7 | e988e794d4d4b6dd43bc0e89d6e90c43 |
+| appkey | appsec（sign盐值） | 来源 | 备注 |
+| ---------------- | -------------------------------- | ---------- | -------- |
+| 07da50c9a0bf829f | 75d35aa5c06fb46e40059a6a5bf671a6 | 安卓概念版 | |
+| 1d8b6e7d45233436 | 560c52ccd288fed045859ed18bffd973 | 安卓 | |
+| 37207f2beaebf8d7 | e988e794d4d4b6dd43bc0e89d6e90c43 | biliLink | |
+| 4409e2ce8ffd12b8 | 59b43e04ad6965f34319062b478f83dd | TV端 | |
+| 85eb6835b0a1034e | 2ad42749773c441109bdc0191257a664 | | |
+| bb3101000e232e27 | 36efcfed79309338ced0380abd824ac1 | | |
+| bca7e84c2d947ac6 | | 安卓 | 登录专用 |
+| cc578d267072c94d | | 轻视频 | |
+| cc8617fd6961e070 | | 漫画 | |
+| iVGUTjsxvpLeuDCf | aHRmhWMLkdeMuILqORnYZocwMBpMEOdt | 安卓 | 取流专用 |
例如：
diff --git a/other/ip.md b/other/ip.md
index 0b7331a..f710b7e 100644
--- a/other/ip.md
+++ b/other/ip.md
@@ -8,12 +8,12 @@
根对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------ |
-| code | num | 返回值 | 0：成功 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | obj | 信息本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------- |
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
`data`对象：
diff --git a/other/time_stamp.md b/other/time_stamp.md
index 1f635da..ea7c5ff 100644
--- a/other/time_stamp.md
+++ b/other/time_stamp.md
@@ -8,12 +8,12 @@
根对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------ |
-| code | num | 返回值 | 0：成功 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | obj | 信息本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------- |
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
`data`对象：
diff --git a/other/zone_online.md b/other/zone_online.md
index ccebf3e..a16b150 100644
--- a/other/zone_online.md
+++ b/other/zone_online.md
@@ -8,12 +8,12 @@
根对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------ |
-| code | num | 返回值 | 0：成功 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | obj | 信息本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------- |
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
`data`对象：
diff --git a/ranking&dynamic/dynamic.md b/ranking&dynamic/dynamic.md
index 2df39b2..f8af7ce 100644
--- a/ranking&dynamic/dynamic.md
+++ b/ranking&dynamic/dynamic.md
@@ -22,7 +22,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/ranking&dynamic/ranking.md b/ranking&dynamic/ranking.md
index 4d690b7..aadd3f9 100644
--- a/ranking&dynamic/ranking.md
+++ b/ranking&dynamic/ranking.md
@@ -25,7 +25,7 @@
| ------- | ------ | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 视频列表 | |
`data`数组：
diff --git a/search/search_request.md b/search/search_request.md
index fb4179b..5bafa28 100644
--- a/search/search_request.md
+++ b/search/search_request.md
@@ -30,7 +30,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/search/search_response.md b/search/search_response.md
index 6b8588f..bdedcfe 100644
--- a/search/search_response.md
+++ b/search/search_response.md
@@ -84,8 +84,6 @@
}
```
-
-
## 对象类型2-结果为番剧&影视
| 字段 | 类型 | 内容 | 备注 |
@@ -310,8 +308,6 @@
},
```
-
-
## 对象类型3-结果为直播间
| 字段 | 类型 | 内容 | 备注 |
@@ -375,8 +371,6 @@
}
```
-
-
## 对象类型4-结果为主播
| 字段 | 类型 | 内容 | 备注 |
@@ -428,8 +422,6 @@
}
```
-
-
## 对象类型5-结果为专栏
| 字段 | 类型 | 内容 | 备注 |
@@ -484,8 +476,6 @@
}
```
-
-
## 对象类型6-结果为话题
| 字段 | 类型 | 内容 | 备注 |
@@ -546,8 +536,6 @@
}
```
-
-
## 对象类型7-结果为用户
| 字段 | 类型 | 内容 | 备注 |
@@ -688,8 +676,6 @@
}
```
-
-
## 对象类型8-结果为相簿
| 字段 | 类型 | 内容 | 备注 |
@@ -737,4 +723,3 @@
"rank_score": 25315
}
```
-
diff --git a/user/check_nickname.md b/user/check_nickname.md
index f8cdde7..bf8281a 100644
--- a/user/check_nickname.md
+++ b/user/check_nickname.md
@@ -1,7 +1,6 @@
# 检查昵称是否可注册
也可用于判断指定昵称的用户是否存在
-###
> http://passport.bilibili.com/web/generic/check/nickname
*请求方式:GET*
diff --git a/user/info.md b/user/info.md
index 0c2fed0..af66df0 100644
--- a/user/info.md
+++ b/user/info.md
@@ -21,7 +21,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -224,7 +224,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -431,7 +431,7 @@ curl -G 'api.bilibili.com/x/web-interface/card'\
| ------- | ---- | -------- | ------------------------- |
| code | num | 返回值 | 0：成功
-101：未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | **作用尚不明确** |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/user/relation.md b/user/relation.md
index e1e089a..fa5aed0 100644
--- a/user/relation.md
+++ b/user/relation.md
@@ -26,7 +26,7 @@
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -187,7 +187,7 @@ curl -G 'http://api.bilibili.com/x/relation/followers'\
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
@@ -369,7 +369,7 @@ curl -G 'http://api.bilibili.com/x/relation/ollowings'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22003：用户位于黑名单 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -414,7 +414,7 @@ curl 'http://http://api.bilibili.com/x/relation/modify'\
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -482,7 +482,7 @@ curl -G 'http://http://api.bilibili.com/x/relation'\
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -574,7 +574,7 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation'\
| ------- | ------ | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 分组列表 | |
`data`数组：
@@ -650,7 +650,7 @@ curl 'http://api.bilibili.com/x/relation/tags'\
| ------- | ------ | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
22104：该分组不存在 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 成员列表 | |
`data`数组：
@@ -783,7 +783,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag'\
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -832,7 +832,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag/user'\
| ------- | ----- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 成员列表 | |
`data`数组：
@@ -903,7 +903,7 @@ curl 'http://api.bilibili.com/x/relation/tag/special'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22106：该分组已经存在
22103：分组名过长 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -958,7 +958,7 @@ curl 'http://api.bilibili.com/x/relation/tag/create'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22103：分组名过长
22104：该分组不存在 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -1005,7 +1005,7 @@ curl 'http://api.bilibili.com/x/relation/tag/update'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
示例：
@@ -1052,7 +1052,7 @@ curl 'http://api.bilibili.com/x/relation/tag/del'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -1098,7 +1098,7 @@ curl 'http://api.bilibili.com/x/relation/tags/addUsers'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
@@ -1145,7 +1145,7 @@ curl 'http://api.bilibili.com/x/relation/tags/copyUsers'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
diff --git a/user/space.md b/user/space.md
index 8709f43..ea751f7 100644
--- a/user/space.md
+++ b/user/space.md
@@ -1,8 +1,12 @@
# 用户空间相关
-## 查询相关
+## 主页
-### 查询用户置顶视频
+
+
+### 置顶视频
+
+#### 查询用户置顶视频
>http://api.bilibili.com/x/space/top/arc
@@ -24,13 +28,11 @@
| ------- | ---- | -------- | ---------------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
53016：没有置顶视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
-基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
-
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------------------ | ----------------------- |
| aid | num | 视频avID | |
@@ -110,7 +112,10 @@
查询用户`UID=23215368`的置顶视频
-http://api.bilibili.com/x/space/top/arc?vmid=23215368
+```shell
+curl -G 'http://api.bilibili.com/x/space/top/arc'\
+--data-urlencode 'vmid=23215368'
+```
```json
{
@@ -177,9 +182,104 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368
}
```
+#### 设置置顶视频
+> http://api.bilibili.com/x/space/top/arc/set
-### 查询用户代表作视频列表
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------------ | -------------------------------- |
+| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
+| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符
默认为空 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-304：未修改
-400：请求错误
53014：稿件已失效
53015：备注过长
53017：置顶非自己的稿件 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+
+**示例：**
+
+置顶视频`av98948772`/`BV1n741127LD`
+
+avID方式：
+
+```shell
+curl 'http://api.bilibili.com/x/space/top/arc/set'\
+--data-urlencode 'aid=98948772'\
+-b 'SESSDATA=xxx'
+```
+
+bvID方式：
+
+```shell
+curl 'http://api.bilibili.com/x/space/top/arc/set'\
+--data-urlencode 'bvid=BV1n741127LD'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+#### 取消置顶视频
+
+> http://api.bilibili.com/x/space/top/arc/cancel
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误（重复取消） |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+
+**示例：**
+
+```shell
+curl 'http://api.bilibili.com/x/space/top/arc/cancel'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+### 代表作视频
+
+#### 查询用户代表作视频列表
> http://api.bilibili.com/x/space/masterpiece
@@ -203,7 +303,7 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368
| ------- | ------ | ---------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 代表作列表 | |
`data`数组：
@@ -222,7 +322,10 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368
查询用户`UID=23215368`的代表作视频列表
-http://api.bilibili.com/x/space/masterpiece?vmid=23215368
+```shell
+curl -G 'http://api.bilibili.com/x/space/masterpiece'\
+--data-urlencode 'vmid=23215368'
+```
```json
{
@@ -402,13 +505,244 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
}
```
+#### 添加代表作视频
+> http://api.bilibili.com/x/space/masterpiece/add
-### 查询用户投稿视频明细
+*请求方式：POST*
-
+认证方式：Cookie（SESSDATA）
-> http://api.bilibili.com/x/space/arc/search
+代表作上限为3个稿件
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------------ | -------------------------------- |
+| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
+| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符
默认为空 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
53014：稿件已失效
53015：备注过长
53017：置顶非自己的稿件
53019：达到上限
53020：已经存在该稿件 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+
+**示例：**
+
+添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表
+
+avID方式：
+
+```shell
+curl 'http://api.bilibili.com/x/space/masterpiece/add'\
+--data-urlencode 'aid=94916552'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
+
+bvID方式：
+
+```shell
+curl 'http://api.bilibili.com/x/space/masterpiece/add'\
+--data-urlencode 'bvid=BV1ZE411K7ux'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+#### 删除代表作视频
+
+> http://api.bilibili.com/x/space/masterpiece/cancel
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ 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：请求错误
53021：置顶列表中没有该视频 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | 作用尚不明确 |
+
+**示例：**
+
+删除置顶视频`av59765630`/`BV1Yt41137T6`
+
+avID方式：
+
+```shell
+curl 'api.bilibili.com/x/space/masterpiece/cancel'\
+--data-urlencode 'aid=59765630'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
+
+bvID方式：
+
+```shell
+curl 'http://api.bilibili.com/x/space/masterpiece/cancel'\
+--data-urlencode 'bvid=BV1Yt41137T6'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
+
+### 个人TAG
+
+#### 查看用户个人TAG
+
+> http://api.bilibili.com/x/space/acc/tags
+
+*请求方式：GET*
+
+上限5条，且内容由用户自定义
+
+带有转义
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| mid | num | 目标用户UID | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | array | 信息本体 | |
+
+`data`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | -------- | ------------- |
+| 0 | obj | 套了个娃 | 只有1项？？？ |
+
+`data`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ----- | ----------- | ---- |
+| mid | num | 目标用户UID | |
+| tags | array | TAG名称 | |
+
+`data`数组中的对象中的`tags`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | -------- | ------- |
+| 0 | str | TAG1 | |
+| n | str | TAG(n+1) | |
+| …… | str | …… | |
+| 4 | str | TAG5 | 上限5条 |
+
+**示例：**
+
+查看用户`UID=53456`的个人TAG
+
+```shell
+curl -G 'http://api.bilibili.com/x/space/acc/tags'\
+--data-urlencode 'mid=53456'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": [
+ {
+ "mid": 53456,
+ "tags": [
+ "游戏",
+ "音乐",
+ "warma",
+ "搞笑",
+ "动画"
+ ]
+ }
+ ]
+}
+```
+
+#### 修改个人TAG
+
+> http://api.bilibili.com/x/space/acc/tags/set
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`存在且不为0
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
+| tags | strs | 要设置的TAG内容 | 非必要 | 删除公告留空或省去即可
各TAG长度小于10字符
最多5个TAG
各TAG之间用","(%2C)分隔
重复TAG无效 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误（超出长度限制） |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+
+**示例：**
+
+修改个人TAG为`minecraft,技术宅,大佬,小哥哥,可爱`
+
+```shell
+curl 'http://api.bilibili.com/x/space/acc/tags/set'\
+--data-urlencode 'tags=minecraft,技术宅,大佬,小哥哥,可爱'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx;DedeUserID=1'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+### 空间公告
+
+#### 查看用户空间公告
+
+> http://api.bilibili.com/x/space/notice
*请求方式：GET*
@@ -417,8 +751,306 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
-| pn | num | 页码 | 必要 | |
-| ps | num | 每页项数 | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | str | 公告信息 | 无则为空 |
+
+**示例：**
+
+查看用户`UID=53456`的空间公告
+
+```shell
+curl -G 'http://api.bilibili.com/x/space/notice'\
+--data-urlencode 'mid=53456'
+```
+
+```json
+{
+ "code":0,
+ "message":"0",
+ "ttl":1,
+ "data":"我的微博 @_warma_\n直播录像上传到：warma养鸽场\n头像画师是：微博@Dr-H_喵_\n横幅画师：@薬屋"
+}
+```
+
+#### 修改空间公告
+
+> http://api.bilibili.com/x/space/notice/set
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | --------------------------------------- |
+| notice | str | 要设置的公告内容 | 非必要 | 删除公告留空或省去即可
少于150字符 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-304：未修改
-400：请求错误（超出长度限制） |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | 作用尚不明确 |
+
+**示例：**
+
+修改个人空间公告为`鸽子`
+
+```shell
+curl 'http://api.bilibili.com/x/space/notice/set'\
+--data-urlencode 'notice=鸽子'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+### 主页板块布局与权限
+
+#### 调整空间板块布局
+
+> http://space.bilibili.com/ajax/settings/setIndexOrder
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`及`DedeUserID__ckMd5`存在且不为0，referer为 `.bilibili.com`域名下
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
+| index_order | nums | 布局列表 | 必要 | 每个值之间用","（%2C）分隔
先左侧布局再右侧布局
值的意义见下表 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+布局参数`index_order`：
+
+| 值 | 含义 |
+| ---- | ---------------------- |
+| 1 | （左侧）我的稿件 |
+| 2 | （左侧）我的收藏夹 |
+| 3 | （左侧）订阅番剧 |
+| 4 | （左侧）订阅标签 |
+| 5 | （左侧）最近投币的视频 |
+| 6 | **作用尚不明确** |
+| 7 | （左侧）我的频道 |
+| 8 | （左侧）我的专栏 |
+| 9 | （左侧）我的相簿 |
+| 21 | （右侧）公告 |
+| 22 | （右侧）直播间 |
+| 23 | （右侧）个人资料 |
+| 24 | （右侧）官方活动 |
+| 25 | （右侧）最近玩的游戏 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------ | ---- | -------- | ----------------------------------- |
+| ststus | bool | 操作结果 | true：操作成功
false：操作失败 |
+| data | str | 错误信息 | 正确时无此项 |
+
+**示例：**
+
+调整空间布局为：
+
+>我的稿件 直播间
+>我的专栏 个人资料
+>订阅番剧 公告
+>我的收藏夹 官方活动
+>我的相簿 最近玩的游戏
+>最近投币的视频
+>订阅标签
+>我的频道
+
+```shell
+curl 'http://space.bilibili.com/ajax/settings/setIndexOrder'\
+--data-urlencode 'index_order=1,8,3,2,9,5,4,7,22,23,21,24,25,6'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;'\
+-e 'https://www.bilibili.com'
+```
+
+```json
+{
+ "status": true
+}
+```
+
+#### 修改空间隐私权限
+
+> http://space.bilibili.com/ajax/settings/setPrivacy
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`及`DedeUserID__ckMd5`存在且不为0，referer为 `.bilibili.com`域名下
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------------ | ------ | ---------------------------------- |
+| fav_video | num | 收藏视频 | 非必要 | 0：隐藏
1：公开
**下同** |
+| bangumi | num | 追番及追剧 | 非必要 | |
+| tags | num | 关注的TAG | 非必要 | |
+| coins_video | num | 投币的视频 | 非必要 | |
+| user_info | num | 个人信息 | 非必要 | |
+| played_game | num | 玩过的游戏 | 非必要 | |
+| csrf | nstr | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------ | ---- | -------- | ----------------------------------- |
+| ststus | bool | 操作结果 | true：操作成功
false：操作失败 |
+| data | str | 错误信息 | 正确时无此项 |
+
+**示例：**
+
+设置`关注的TAG`为隐藏
+
+```shell
+curl 'http://space.bilibili.com/ajax/settings/setPrivacy'\
+--data-urlencode 'tags=0'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;'\
+-e 'https://www.bilibili.com'
+```
+
+```json
+{
+ "status": true
+}
+```
+
+### 查询用户最近玩过的游戏
+
+> http://api.bilibili.com/x/space/lastplaygame
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| mid | num | 目标用户UID | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ------------------------------- | -------- | ---------------------------------------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误
53013：用户隐私设置未公开 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | 隐藏时：null
公开时：array | 信息本体 | |
+
+`data`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------- | ---------------- |
+| 0 | obj | 游戏1 | |
+| n | obj | 游戏(n+1) | 项数为总计游戏数 |
+| …… | obj | …… | …… |
+
+`data`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | --------------- | ---- |
+| website | str | 游戏主页链接url | |
+| image | str | 游戏图片url | |
+| name | str | 游戏名 | |
+
+**示例：**
+
+查询`UID=2`的最近玩过的游戏
+
+```shell
+curl -G 'http://api.bilibili.com/x/space/lastplaygame'\
+--data-urlencode 'mid=2 '
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": [
+ {
+ "website": "https://game.bilibili.com/fgo/event_meihosou",
+ "image": "http://i0.hdslb.com/bfs/game/f7d4ee0877089e4079b8f0b4f5c95dd4ceba512a.png",
+ "name": "命运-冠位指定（Fate/GO）"
+ },
+ {
+ "website": "https://game.bilibili.com/pcr/xxtix",
+ "image": "http://i0.hdslb.com/bfs/game/7922ecea5cc76fe3c8c177e1d4a6c8cf1c36a700.jpg",
+ "name": "公主连结Re:Dive"
+ },
+ {
+ "website": "https://game.bilibili.com/dwbgx/",
+ "image": "http://i0.hdslb.com/bfs/game/6d5b2df70dfa987408d8d09110cdc327949885e3.png",
+ "name": "大王不高兴"
+ },
+ {
+ "website": "https://game.bilibili.com/bangdream/1stanniversary-yxzx/",
+ "image": "http://i0.hdslb.com/bfs/game/4a7d0b7272dffe5a489ee935b6bd2d4f7d5f1257.png",
+ "name": "BanG Dream！"
+ },
+ {
+ "website": "http://www.biligame.com/detail/?id=101772",
+ "image": "http://i0.hdslb.com/bfs/game/8e8b04e7bd2170c2ba2c9f563a62c72bac2eba2c.jpg",
+ "name": "明日方舟"
+ }
+ ]
+}
+```
+
+## 投稿
+
+
+
+### 查询用户投稿视频明细
+
+> http://api.bilibili.com/x/space/arc/search
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------- | ---- | ------------ | ------ | ------------------------------------------------------------ |
+| mid | num | 目标用户UID | 必要 | |
+| order | str | 排序方式 | 非必要 | 默认为pubdate
最新发布：pubdate
最多播放：click
最多收藏：stow |
+| tid | num | 筛选目标分区 | 非必要 | 默认为0
0：不进行分区筛选
分区tID为所筛选的分区 |
+| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
+| pn | num | 页码 | 必要 | |
+| ps | num | 每页项数 | 必要 | |
**json回复：**
@@ -428,7 +1060,7 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-412：请求被拦截 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -506,7 +1138,11 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
以每页2项查询用户`UID=53456`的第1页投稿视频明细
-http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
+```shell
+curl -G 'http://api.bilibili.com/x/space/arc/search'\
+--data-urlencode 'ps=2'\
+--data-urlencode 'pn=1'
+```
```json
{
@@ -588,19 +1224,1003 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
}
```
+### 查询用户投稿相簿预览
+
+> http://api.bilibili.com/x/space/album/index
+
+*请求方式：GET*
+
+所有类型的相簿
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------ | ------ | ------- |
+| mid | num | 目标用户UID | 必要 | |
+| ps | num | 获取的相簿量 | 非必要 | 默认为8 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ------ | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | array | 相簿列表 | |
+
+`data`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0 | obj | 相簿内容1 | |
+| n | obj | 相簿内容（n+1） | |
+| …… | obj | …… | …… |
+
+`data`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ------ | ----------- | -------------- |
+| count | num | 总计图片数 | |
+| ctime | num | 发布时间 | 时间戳 |
+| description | str | 简介 | |
+| doc_id | num | 相簿ID | 非动态ID！！！ |
+| like | num | 点赞数 | |
+| pictures | array | 图片内容 | |
+| poster_uid | num | 上传用户UID | |
+| title | str | 标题 | 动态内容无 |
+| view | num | 浏览数 | |
+
+`data`数组中的对象中的`pictures`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | --------------------- |
+| 0 | obj | 内容图片1 | |
+| n | obj | 内容图片（n+1） | 项数取决于`count`的值 |
+| …… | obj | …… | …… |
+
+`pictures`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | -------- | ----------- |
+| img_height | num | 图片高度 | |
+| img_size | num | 图片大小 | 单位为KByte |
+| img_src | str | 图片url | |
+| img_width | num | 图片宽度 | |
+
+**示例：**
+
+查询用户`UID=53456`的投稿相簿预览
+
+```shell
+curl -G 'http://api.bilibili.com/x/space/album/index'\
+--data-urlencode 'mid=53456'\
+--data-urlencode 'ps=2'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": [{
+ "doc_id": 60470424,
+ "poster_uid": 53456,
+ "title": "",
+ "description": "你醒啦！[tv_大佬]\n之前说到过的百万粉纪念的视频已经定时在了今天下午七点，欢迎来看呀！",
+ "pictures": [{
+ "img_src": "https://i0.hdslb.com/bfs/album/2840366e30bf7c0aba9da5adde1a771255a57bc7.jpg",
+ "img_width": 625,
+ "img_height": 134,
+ "img_size": 14
+ }],
+ "count": 1,
+ "ctime": 1583444859,
+ "view": 1677521,
+ "like": 29974
+ }, {
+ "doc_id": 58962388,
+ "poster_uid": 53456,
+ "title": "",
+ "description": "上次的那些写实儿童画发出来啦！可以打印下来辟邪[tv_大佬]",
+ "pictures": [{
+ "img_src": "https://i0.hdslb.com/bfs/album/8acaf7c7897cb858cccab36c33a5e875adfef177.jpg",
+ "img_width": 2172,
+ "img_height": 3258,
+ "img_size": 2831
+ }, {
+ "img_src": "https://i0.hdslb.com/bfs/album/1611b6b56d3d4328889a62b9f9bdc92e9d065532.jpg",
+ "img_width": 3456,
+ "img_height": 5184,
+ "img_size": 3024
+ }, {
+ "img_src": "https://i0.hdslb.com/bfs/album/f3a30a2ef5b39711af8b945d54d85ffd1e932b8a.jpg",
+ "img_width": 1200,
+ "img_height": 757,
+ "img_size": 313
+ }],
+ "count": 3,
+ "ctime": 1582881332,
+ "view": 1176646,
+ "like": 25734
+ }]
+}
+```
+
+### 查询用户投稿相簿明细
+
+> http://api.vc.bilibili.com/link_draw/v1/doc/doc_list
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| --------- | ---- | ----------- | ------ | ------------------------------------------------------------ |
+| uid | num | 目标用户UID | 必要 | |
+| page_num | num | 页码 | 非必要 | 默认为1 |
+| page_size | num | 每页项数 | 非必要 | 默认为20 |
+| biz | str | 查询类型 | 非必要 | 全部：all
绘画：draw
摄影：photo
日常：daily
默认为all |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------- |
+| code | num | 返回值 | 0：成功 |
+| msg | str | 错误信息 | 默认为success |
+| message | str | 错误信息 | 默认为success |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ------ | -------- | ---- |
+| items | array | 相簿列表 | |
+
+`items`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0 | obj | 相簿内容1 | |
+| n | obj | 相簿内容（n+1） | |
+| …… | obj | …… | …… |
+
+`items`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ------ | ----------- | -------------- |
+| count | num | 总计图片数 | |
+| ctime | num | 发布时间 | 时间戳 |
+| description | str | 简介 | |
+| doc_id | num | 相簿ID | 非动态ID！！！ |
+| like | num | 点赞数 | |
+| pictures | array | 图片内容 | |
+| poster_uid | num | 上传用户UID | |
+| title | str | 标题 | 动态内容无 |
+| view | num | 浏览数 | |
+
+`items`数组中的对象中的`pictures`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | --------------------- |
+| 0 | obj | 内容图片1 | |
+| n | obj | 内容图片（n+1） | 项数取决于`count`的值 |
+| …… | obj | …… | …… |
+
+`pictures`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | -------- | ----------- |
+| img_height | num | 图片高度 | |
+| img_size | num | 图片大小 | 单位为KByte |
+| img_src | str | 图片url | |
+| img_width | num | 图片宽度 | |
+
+**示例：**
+
+查询用户`UID=53456`的投稿明细中的全部类型
+
+```shell
+curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list'\
+--data-urlencode 'uid=2'\
+--data-urlencode 'page_num=1'\
+--data-urlencode 'page_size=2'\
+--data-urlencode 'biz=all'
+```
+
+```json
+{
+ "code": 0,
+ "msg": "success",
+ "message": "success",
+ "data": {
+ "items": [{
+ "doc_id": 59015720,
+ "poster_uid": 2,
+ "title": "",
+ "description": "6影是真的无脑，2个宝石都护不住（设计师：这真是太酷了）",
+ "pictures": [{
+ "img_src": "http://i0.hdslb.com/bfs/album/8456f050ec8639c6e0cef36aba27bfdedc550590.jpg",
+ "img_width": 1824,
+ "img_height": 840,
+ "img_size": 1024
+ }],
+ "count": 1,
+ "ctime": 1582894607,
+ "view": 707073,
+ "like": 7055
+ }, {
+ "doc_id": 46853140,
+ "poster_uid": 2,
+ "title": "",
+ "description": "#年度报告# #新年Flag# https://www.bilibili.com/blackboard/timemachine2019.html\n决定了，这就是我的新年Flag！今年我一定要…",
+ "pictures": [{
+ "img_src": "http://i0.hdslb.com/bfs/album/5b3ae76f79d7cf2501afc3ca7c7da509dcf0e38a.jpg",
+ "img_width": 1125,
+ "img_height": 2184,
+ "img_size": 465
+ }, {
+ "img_src": "http://i0.hdslb.com/bfs/album/87789fe9644337a1f7e6a0655a32584705af8bda.jpg",
+ "img_width": 1125,
+ "img_height": 2184,
+ "img_size": 421
+ }, {
+ "img_src": "http://i0.hdslb.com/bfs/album/f752d7f3bb7952f6c0013b3f48ddcb07060b4721.jpg",
+ "img_width": 1125,
+ "img_height": 2184,
+ "img_size": 524
+ }, {
+ "img_src": "http://i0.hdslb.com/bfs/active/7a52a411bccb716c8e67fe70e6c330d5209346de.jpg",
+ "img_width": 1125,
+ "img_height": 2184,
+ "img_size": 534
+ }],
+ "count": 4,
+ "ctime": 1577966163,
+ "view": 833193,
+ "like": 5667
+ }]
+ }
+}
+```
+
+## 频道
+
+
+
+### 查询用户频道列表
+
+> http://api.bilibili.com/x/space/channel/list
+
+*请求方式：GET*
+
+**url参数：**
+
+| mid | num | 目标用户UID | 必要 | |
+| ------ | ---- | ----------- | ------ | ---- |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | -------- |
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | 无则为空 |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ------ | ---------- | ---- |
+| count | num | 总计频道数 | |
+| list | array | 频道列表 | |
+
+`data`中的`list`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ----------- | --------------------- |
+| 0 | obj | 频道1 | |
+| n | obj | 频道（n+1） | 项数取决于`count`的值 |
+| …… | obj | …… | …… |
+
+`data`中的`list`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | -------------- | -------- |
+| cid | num | 频道ID | |
+| count | num | 频道内含视频数 | |
+| cover | str | 封面图片url | |
+| intro | str | 简介 | 无则为空 |
+| mid | num | 创建用户UID | |
+| mtime | num | 创建时间 | 时间戳 |
+| name | str | 标题 | |
+
+**示例：**
+
+查询用户`UID=53456`的频道列表
+
+```shell
+curl -G 'http://api.bilibili.com/x/space/channel/list'\
+--data-urlencode 'mid=53456'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "count": 6,
+ "list": [{
+ "cid": 100249,
+ "mid": 53456,
+ "name": "【实况】动物之森",
+ "intro": "",
+ "mtime": 1579898830,
+ "count": 2,
+ "cover": "http://i1.hdslb.com/bfs/archive/6a7ed9483c34e839dfca981b9e2b94cd4c4efa0a.jpg"
+ }, {
+ "cid": 79323,
+ "mid": 53456,
+ "name": "忆雨",
+ "intro": "忆雨出现过的视频",
+ "mtime": 1562535222,
+ "count": 7,
+ "cover": "http://i2.hdslb.com/bfs/archive/1783e4f03042b282495799adda1cb56270cea647.jpg"
+ }, {
+ "cid": 79322,
+ "mid": 53456,
+ "name": "大画家",
+ "intro": "",
+ "mtime": 1562535122,
+ "count": 6,
+ "cover": "http://i0.hdslb.com/bfs/archive/9c85a14e805c6c23cb7a42e1dbef97821bb68960.jpg"
+ }, {
+ "cid": 77758,
+ "mid": 53456,
+ "name": "灭火器",
+ "intro": "",
+ "mtime": 1561270856,
+ "count": 4,
+ "cover": "http://i2.hdslb.com/bfs/archive/0073208d086b4ebe9cdc540e7664aa74b483aeb6.jpg"
+ }, {
+ "cid": 75696,
+ "mid": 53456,
+ "name": "沃玛小剧场",
+ "intro": "",
+ "mtime": 1559129460,
+ "count": 5,
+ "cover": "http://i2.hdslb.com/bfs/archive/db2b20ecdb6ed013fc3780b0e741ea88d46b5b40.jpg"
+ }, {
+ "cid": 170,
+ "mid": 53456,
+ "name": "爆炸电台",
+ "intro": "闲聊的电台",
+ "mtime": 1503298893,
+ "count": 7,
+ "cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg"
+ }]
+ }
+}
+```
-### 查询用户追番预览列表
-
+### 查询用户频道中的视频
+
+> http://api.bilibili.com/x/space/channel/video
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | --------- |
+| mid | num | 目标用户UID | 必要 | |
+| cid | num | 目标频道ID | 必要 | |
+| pn | num | 页码 | 非必要 | 默认为1 |
+| ps | num | 每页项数 | 非必要 | 默认为100 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误
-404：无用户对应的频道 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | -------- | ---- |
+| list | obj | 频道信息 | |
+| page | obj | 页面信息 | |
+
+`data`中的`list`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ------ | -------------- | -------- |
+| archives | array | 包含的视频列表 | |
+| cid | num | 频道ID | |
+| count | num | 频道内含视频数 | |
+| cover | str | 封面图片url | |
+| intro | str | 简介 | 无则为空 |
+| mid | num | 创建用户UID | |
+| mtime | num | 创建时间 | 时间戳 |
+| name | str | 标题 | |
+
+`list`中的`archives`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ----------- | --------------------- |
+| 0 | obj | 视频1 | |
+| n | obj | 视频（n+1） | 项数取决于`count`的值 |
+| …… | obj | …… | …… |
+
+`list`中的`archives`数组中的对象：
+
+基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
+
+`data`中的`page`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | ---------- | ---- |
+| count | num | 总计视频数 | |
+| num | num | 当前页码 | |
+| size | num | 每页项数 | |
+
+**示例：**
+
+查询用户`UID=53456`的频道`170`中的视频
+
+```shell
+curl -G 'http://api.bilibili.com/x/space/channel/video'\
+--data-urlencode 'mid=53456'\
+--data-urlencode 'cid=170'\
+--data-urlencode 'ps=2'\
+--data-urlencode 'pn=1'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": {
+ "cid": 170,
+ "mid": 53456,
+ "name": "爆炸电台",
+ "intro": "闲聊的电台",
+ "mtime": 1503298893,
+ "count": 7,
+ "cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg",
+ "archives": [{
+ "aid": 87673204,
+ "videos": 1,
+ "tid": 21,
+ "tname": "日常",
+ "copyright": 1,
+ "pic": "http://i0.hdslb.com/bfs/archive/5387bdcbbe4d5551adbf0ee2e607e4b7d3d8f2f0.jpg",
+ "title": "【warma爆炸电台】迟来的自我介绍【第八期】",
+ "pubdate": 1581244539,
+ "ctime": 1581244540,
+ "desc": "时隔半年的新的一期爆炸电台来啦，这是我的一系列杂谈聊天电台，这次因为多了很多新关注的朋友们，所以来做个自我介绍吧！\n画师：Dr-H_喵_ 动画：K_Lacid\n结尾提到的壁纸稍后在动态发原图，动态壁纸在steam那个壁纸软件的创意工坊里搜warma能找到\n\n往期的电台：\n第一期：av6786024 \n第三期：av13619263\n第四期：av18862091\n第五期：av25092410\n第六期：av42492515\n第七期：av62910468",
+ "state": 0,
+ "attribute": 16512,
+ "duration": 2388,
+ "rights": {
+ "bp": 0,
+ "elec": 0,
+ "download": 0,
+ "movie": 0,
+ "pay": 0,
+ "hd5": 0,
+ "no_reprint": 1,
+ "autoplay": 1,
+ "ugc_pay": 0,
+ "is_cooperation": 0,
+ "ugc_pay_preview": 0,
+ "no_background": 0
+ },
+ "owner": {
+ "mid": 53456,
+ "name": "Warma",
+ "face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
+ },
+ "stat": {
+ "aid": 87673204,
+ "view": 1383542,
+ "danmaku": 88908,
+ "reply": 9237,
+ "favorite": 32929,
+ "coin": 68849,
+ "share": 5140,
+ "now_rank": 0,
+ "his_rank": 52,
+ "like": 116164,
+ "dislike": 0
+ },
+ "dynamic": "来做个自我介绍吧！ #warma##沃玛##爆炸电台#",
+ "cid": 149793525,
+ "dimension": {
+ "width": 1920,
+ "height": 1080,
+ "rotate": 0
+ },
+ "bvid": "BV1D7411t7Be",
+ "inter_video": false
+ }, {
+ "aid": 62910468,
+ "videos": 1,
+ "tid": 21,
+ "tname": "日常",
+ "copyright": 1,
+ "pic": "http://i2.hdslb.com/bfs/archive/4bd598f71a144d4505e259b143c0de0bf27968b2.jpg",
+ "title": "【warma爆炸电台】居然收到了几千条问题！【第七期】",
+ "pubdate": 1565345410,
+ "ctime": 1565338559,
+ "desc": "时隔半年的爆炸电台第七期终于来啦！在这一期里回答了很多问题，祝看得开心！此外，就在昨天，50万订阅了…真的谢谢大家！\n也欢迎来看往期的电台：\n第一期：av6786024 （2016年10月）\n第二期：av10373352（2017年5月）\n第三期：av13619263（2017年8月）\n第四期：av18862091（2018年1月）\n第五期：av25092410（2018年6月）\n第六期：av42492515（2019年2月）",
+ "state": 0,
+ "attribute": 16512,
+ "duration": 1987,
+ "mission_id": 11740,
+ "rights": {
+ "bp": 0,
+ "elec": 0,
+ "download": 0,
+ "movie": 0,
+ "pay": 0,
+ "hd5": 0,
+ "no_reprint": 1,
+ "autoplay": 1,
+ "ugc_pay": 0,
+ "is_cooperation": 0,
+ "ugc_pay_preview": 0,
+ "no_background": 0
+ },
+ "owner": {
+ "mid": 53456,
+ "name": "Warma",
+ "face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
+ },
+ "stat": {
+ "aid": 62910468,
+ "view": 455277,
+ "danmaku": 19383,
+ "reply": 2108,
+ "favorite": 10507,
+ "coin": 19422,
+ "share": 1208,
+ "now_rank": 0,
+ "his_rank": 0,
+ "like": 31515,
+ "dislike": 0
+ },
+ "dynamic": "爆炸电台 第七期 来啦！",
+ "cid": 109284065,
+ "dimension": {
+ "width": 1920,
+ "height": 1080,
+ "rotate": 0
+ },
+ "bvid": "BV1gt411K7Ga",
+ "inter_video": false
+ }]
+ },
+ "page": {
+ "count": 7,
+ "num": 1,
+ "size": 2
+ }
+ }
+}
+```
+
+### 创建频道
+
+> http://api.bilibili.com/x/space/channel/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| name | str | 频道名 | 必要 | |
+| intro | str | 频道简介 | | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+
+
+
+
+### 修改频道
+
+> http://api.bilibili.com/x/space/channel/edit
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| cid | num | 频道ID | 必要 | |
+| name | str | 频道名 | | |
+| intro | str | 频道简介 | | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+
+
+### 删除频道
+
+> http://api.bilibili.com/x/space/channel/del
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| cid | num | 频道ID | 必要 | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+
+
+
+
+### 添加频道视频
+
+> http://api.bilibili.com/x/space/channel/video/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| cid | num | 频道ID | 必要 | |
+| aids | nums | 要添加的目标视频avID | 必要 | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+
+
+
+
+### 删除频道视频
+
+> https://api.bilibili.com/x/space/channel/video/del
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| cid | num | 频道ID | 必要 | |
+| aid | num | 要删除的目标视频avID | 必要 | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+
+
+### 调整频道视频顺序
+
+> http://api.bilibili.com/x/space/channel/video/sort
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| cid | num | 频道ID | 必要 | |
+| aid | num | | 必要 | |
+| to | num | | | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+
+
+
+
+
+
+
+
+## 收藏
+
+### 查询用户创建的视频收藏夹
+
+> http://api.bilibili.com/x/v3/fav/folder/created/list-all
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+查看私有收藏夹时需要认证
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| up_mid | num | 目标用户UID | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----------------------------- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | 隐藏时：null
公开时：obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | --------------------------------------- | -------------- | ---- |
+| count | num | 创建的收藏夹数 | |
+| list | 无收藏夹时：null
有收藏夹时：array | 收藏夹列表 | |
+
+`data`中的`list`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ----------- | --------------------- |
+| 0 | obj | 收藏夹1 | |
+| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
+| …… | obj | …… | |
+
+`data`中的`list`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | ---------------- | ----------------------------------------- |
+| id | num | 收藏夹mlID | |
+| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
+| mid | num | 创建用户UID | |
+| attr | num | 收藏夹属性 | 转换成8-bit二进制处理
详细说明见下表 |
+| title | str | 收藏夹标题 | |
+| fav_state | num | 0 | 作用尚不明确 |
+| media_count | num | 收藏夹总计视频数 | |
+
+`attr`属性二进制值表：
+
+| 其他有待补充... | 1：默认收藏夹 | 0：公开性 |
+| --------------- | -------------------------------- | -------------------- |
+| | 0：默认收藏夹
1：其他收藏夹 | 0：公开
1：私有 |
+
+**示例：**
+
+查询用户`UID=7792521`的收藏夹列表
+
+```shell
+curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all'\
+--data-urlencode 'up_mid=7792521'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "count": 5,
+ "list": [{
+ "id": 44233921,
+ "fid": 442339,
+ "mid": 7792521,
+ "attr": 0,
+ "title": "默认收藏夹",
+ "fav_state": 0,
+ "media_count": 85
+ }, {
+ "id": 936347621,
+ "fid": 9363476,
+ "mid": 7792521,
+ "attr": 22,
+ "title": "放假君的鬼畜私房歌",
+ "fav_state": 0,
+ "media_count": 2
+ }, {
+ "id": 845218621,
+ "fid": 8452186,
+ "mid": 7792521,
+ "attr": 22,
+ "title": "♪一言不合就开唱♪",
+ "fav_state": 0,
+ "media_count": 4
+ }, {
+ "id": 844998121,
+ "fid": 8449981,
+ "mid": 7792521,
+ "attr": 22,
+ "title": "个人作品精选",
+ "fav_state": 0,
+ "media_count": 25
+ }, {
+ "id": 381779121,
+ "fid": 3817791,
+ "mid": 7792521,
+ "attr": 22,
+ "title": "鬼畜小课堂",
+ "fav_state": 0,
+ "media_count": 25
+ }]
+ }
+}
+```
+
+### 查询用户收藏的视频收藏夹
+
+> http://api.bilibili.com/x/v3/fav/folder/collected/list
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| ps | num | 每页项数 | 必要 | |
+| pn | num | 页码 | 必要 | |
+| up_mid | num | 目标用户UID | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
40022：签名过长 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | 隐藏时：null
公开时：obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | --------------------------------------- | -------------- | ---- |
+| count | num | 创建的收藏夹数 | |
+| list | 无收藏夹时：null
有收藏夹时：array | 收藏夹列表 | |
+
+`data`中的`list`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ----------- | --------------------- |
+| 0 | obj | 收藏夹1 | |
+| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
+| …… | obj | …… | |
+
+`data`中的`list`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | ------------------ | ----------------------------------------- |
+| id | num | 收藏夹mlID | |
+| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
+| mid | num | 创建用户UID | |
+| attr | num | 收藏夹属性 | 转换成8-bit二进制处理
详细说明见下表 |
+| title | str | 收藏夹标题 | |
+| cover | str | 收藏夹封面图片url | |
+| upper | obj | 收藏夹创建用户信息 | |
+| cover_type | num | 2 | 作用尚不明确 |
+| intro | str | 空 | 作用尚不明确 |
+| ctime | num | 创建时间 | 时间戳 |
+| mtime | num | 审核时间 | 时间戳 |
+| state | num | 0 | 作用尚不明确 |
+| fav_state | num | 0 | 作用尚不明确 |
+| media_count | num | 收藏夹总计视频数 | |
+
+`attr`属性二进制值表：
+
+| 其他有待补充... | 1：默认收藏夹 | 0：公开性 |
+| --------------- | -------------------------------- | -------------------- |
+| | 0：默认收藏夹
1：其他收藏夹 | 0：公开
1：私有 |
+
+`data`中的`list`数组中的对象中的`upper`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---------- | ------------ |
+| mid | num | 创建人UID | |
+| name | str | 创建人昵称 | |
+| face | str | 空 | 作用尚不明确 |
+
+**示例：**
+
+查询用户`UID=293793435`的收藏夹收藏列表
+
+```shell
+curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list'\
+--data-urlencode 'up_mid=293793435'\
+--data-urlencode 'ps=20'\
+--data-urlencode 'pn=1'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "count": 2,
+ "list": [{
+ "id": 496307088,
+ "fid": 4963070,
+ "mid": 412466388,
+ "attr": 22,
+ "title": "入站必刷",
+ "cover": "http://i0.hdslb.com/bfs/archive/baae2b4050363c0ab45465b7cf696b8304fdaca8.jpg",
+ "upper": {
+ "mid": 412466388,
+ "name": "热门菌",
+ "face": ""
+ },
+ "cover_type": 2,
+ "intro": "",
+ "ctime": 1563394571,
+ "mtime": 1563394571,
+ "state": 0,
+ "fav_state": 0,
+ "media_count": 55
+ }, {
+ "id": 381779121,
+ "fid": 3817791,
+ "mid": 7792521,
+ "attr": 22,
+ "title": "鬼畜小课堂",
+ "cover": "http://i2.hdslb.com/bfs/archive/09a668cfdb38fb3a85f905c10f48a2947e36a695.jpg",
+ "upper": {
+ "mid": 7792521,
+ "name": "还有一天就放假了",
+ "face": ""
+ },
+ "cover_type": 2,
+ "intro": "",
+ "ctime": 1553700224,
+ "mtime": 1557291666,
+ "state": 0,
+ "fav_state": 0,
+ "media_count": 25
+ }]
+ }
+}
+```
+
+## 订阅
+
+
+
+### 订阅查询用户追番预览列表
> http://space.bilibili.com/ajax/Bangumi/getList
*请求方式：GET*
-带有转义，且只能获取最多15条
+认证方式：Cookie（SESSDATA）
-如设置隐私查看自己的需要登录(SESSDATA)
+如设置隐私查看自己的需要认证
+
+带有转义，且只能获取最多15条
**url参数：**
@@ -619,10 +2239,10 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
`data`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------ | ------ | ------------ | ------------ |
-| count | num | 总计追番数 | |
-| pages | num | 0 | 作用尚不明确 |
+| 字段 | 类型 | 内容 | 备注 |
+| ------ | ----- | ------------ | ------------ |
+| count | num | 总计追番数 | |
+| pages | num | 0 | 作用尚不明确 |
| result | array | 追番预览列表 | |
`data`中的`result`数组：
@@ -654,7 +2274,11 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
查看用户`UID=14082`的追番预览列表
-http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
+```shell
+curl -G 'http://space.bilibili.com/ajax/Bangumi/getList'\
+--data-urlencode 'mid=14082'\
+-b 'SESSDATA=xxx'
+```
```json
{
@@ -693,17 +2317,15 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
}
```
-
-
### 查询用户追番（追剧）明细
-
-
> http://api.bilibili.com/x/space/bangumi/follow/list
*请求方式：GET*
-如设置隐私查看自己的需要登录(SESSDATA)
+认证方式：Cookie（SESSDATA）
+
+如设置隐私查看自己的需要认证
**url参数：**
@@ -722,17 +2344,17 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
| ------- | ---- | -------- | ---------------------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
53013：用户隐私设置未公开 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ------ | ---------- | ---- |
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ----- | ---------- | ---- |
| list | array | 追番列表 | |
-| pn | num | 当前页码 | |
-| ps | num | 每页项数 | |
-| total | num | 总计追番数 | |
+| pn | num | 当前页码 | |
+| ps | num | 每页项数 | |
+| total | num | 总计追番数 | |
`data`中的`list`数组：
@@ -750,7 +2372,14 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
查看用户`UID=14082`的追番明细
-http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
+```shell
+curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list'\
+--data-urlencode 'vmid=14082'\
+--data-urlencode 'type=1'\
+--data-urlencode 'ps=2'\
+--data-urlencode 'pn=1'\
+-b 'SESSDATA=xxx'
+```
```json
{
@@ -945,18 +2574,22 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
+
+
### 查询用户关注的TAG（话题）
> http://space.bilibili.com/ajax/tags/getSubList
*请求方式：GET*
+认证方式：Cookie（SESSDATA）
+
+如设置隐私查看自己的需要认证
+
带有转义
只显示前100个
-如设置隐私查看自己的需要登录(SESSDATA)
-
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -974,10 +2607,10 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
`data`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ------ | ----------- | ---- |
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ----- | ----------- | ---- |
| tags | array | 关注TAG列表 | |
-| count | num | 关注TAG的数 | |
+| count | num | 关注TAG的数 | |
`data`中的`tags`数组：
@@ -1003,7 +2636,11 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
查询用户`UID=2`的关注TAG
-http://space.bilibili.com/ajax/tags/getSubList?mid=2
+```shell
+curl -G 'http://space.bilibili.com/ajax/tags/getSubList'\
+--data-urlencode 'mid=2'\
+-b 'SESSDATA=xxx'
+```
```json
{
@@ -1030,1449 +2667,3 @@ http://space.bilibili.com/ajax/tags/getSubList?mid=2
}
}
```
-
-
-
-
-
-### 查询用户投稿相簿预览
-
-> http://api.bilibili.com/x/space/album/index
-
-*请求方式：GET*
-
-所有类型的相簿
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------ | ------ | ------- |
-| mid | num | 目标用户UID | 必要 | |
-| ps | num | 获取的相簿量 | 非必要 | 默认为8 |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ------ | -------- | --------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | array | 相簿列表 | |
-
-`data`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | --------------- | ---- |
-| 0 | obj | 相簿内容1 | |
-| n | obj | 相簿内容（n+1） | |
-| …… | obj | …… | …… |
-
-`data`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----------- | ------ | ----------- | -------------- |
-| count | num | 总计图片数 | |
-| ctime | num | 发布时间 | 时间戳 |
-| description | str | 简介 | |
-| doc_id | num | 相册ID | 非动态ID！！！ |
-| like | num | 点赞数 | |
-| pictures | array | 图片内容 | |
-| poster_uid | num | 上传用户UID | |
-| title | str | 标题 | 动态内容无 |
-| view | num | 浏览数 | |
-
-`data`数组中的对象中的`pictures`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | --------------- | --------------------- |
-| 0 | obj | 内容图片1 | |
-| n | obj | 内容图片（n+1） | 项数取决于`count`的值 |
-| …… | obj | …… | …… |
-
-`pictures`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ---------- | ---- | -------- | ----------- |
-| img_height | num | 图片高度 | |
-| img_size | num | 图片大小 | 单位为KByte |
-| img_src | str | 图片url | |
-| img_width | num | 图片宽度 | |
-
-**示例：**
-
-查询用户`UID=53456`的投稿相簿预览
-
-http://api.bilibili.com/x/space/album/index?mid=53456&ps=2
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": [{
- "doc_id": 60470424,
- "poster_uid": 53456,
- "title": "",
- "description": "你醒啦！[tv_大佬]\n之前说到过的百万粉纪念的视频已经定时在了今天下午七点，欢迎来看呀！",
- "pictures": [{
- "img_src": "https://i0.hdslb.com/bfs/album/2840366e30bf7c0aba9da5adde1a771255a57bc7.jpg",
- "img_width": 625,
- "img_height": 134,
- "img_size": 14
- }],
- "count": 1,
- "ctime": 1583444859,
- "view": 1677521,
- "like": 29974
- }, {
- "doc_id": 58962388,
- "poster_uid": 53456,
- "title": "",
- "description": "上次的那些写实儿童画发出来啦！可以打印下来辟邪[tv_大佬]",
- "pictures": [{
- "img_src": "https://i0.hdslb.com/bfs/album/8acaf7c7897cb858cccab36c33a5e875adfef177.jpg",
- "img_width": 2172,
- "img_height": 3258,
- "img_size": 2831
- }, {
- "img_src": "https://i0.hdslb.com/bfs/album/1611b6b56d3d4328889a62b9f9bdc92e9d065532.jpg",
- "img_width": 3456,
- "img_height": 5184,
- "img_size": 3024
- }, {
- "img_src": "https://i0.hdslb.com/bfs/album/f3a30a2ef5b39711af8b945d54d85ffd1e932b8a.jpg",
- "img_width": 1200,
- "img_height": 757,
- "img_size": 313
- }],
- "count": 3,
- "ctime": 1582881332,
- "view": 1176646,
- "like": 25734
- }]
-}
-```
-
-
-
-### 查询用户投稿相簿明细
-
-> http://api.vc.bilibili.com/link_draw/v1/doc/doc_list
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| --------- | ---- | ----------- | ------ | ------------------------------------------------------------ |
-| uid | num | 目标用户UID | 必要 | |
-| page_num | num | 页码 | 非必要 | 默认为1 |
-| page_size | num | 每页项数 | 非必要 | 默认为20 |
-| biz | str | 查询类型 | 非必要 | 全部：all
绘画：draw
摄影：photo
日常：daily
默认为all |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------- |
-| code | num | 返回值 | 0：成功 |
-| msg | str | 错误信息 | 默认为success |
-| message | str | 错误信息 | 默认为success |
-| data | obj | 信息本体 | |
-
-`data`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ------ | -------- | ---- |
-| items | array | 相簿列表 | |
-
-`items`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | --------------- | ---- |
-| 0 | obj | 相簿内容1 | |
-| n | obj | 相簿内容（n+1） | |
-| …… | obj | …… | …… |
-
-`items`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----------- | ------ | ----------- | -------------- |
-| count | num | 总计图片数 | |
-| ctime | num | 发布时间 | 时间戳 |
-| description | str | 简介 | |
-| doc_id | num | 相册ID | 非动态ID！！！ |
-| like | num | 点赞数 | |
-| pictures | array | 图片内容 | |
-| poster_uid | num | 上传用户UID | |
-| title | str | 标题 | 动态内容无 |
-| view | num | 浏览数 | |
-
-`items`数组中的对象中的`pictures`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | --------------- | --------------------- |
-| 0 | obj | 内容图片1 | |
-| n | obj | 内容图片（n+1） | 项数取决于`count`的值 |
-| …… | obj | …… | …… |
-
-`pictures`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ---------- | ---- | -------- | ----------- |
-| img_height | num | 图片高度 | |
-| img_size | num | 图片大小 | 单位为KByte |
-| img_src | str | 图片url | |
-| img_width | num | 图片宽度 | |
-
-**示例：**
-
-查询用户`UID=53456`的投稿明细中的全部类型
-
-http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size=2&biz=all
-
-```json
-{
- "code": 0,
- "msg": "success",
- "message": "success",
- "data": {
- "items": [{
- "doc_id": 59015720,
- "poster_uid": 2,
- "title": "",
- "description": "6影是真的无脑，2个宝石都护不住（设计师：这真是太酷了）",
- "pictures": [{
- "img_src": "http://i0.hdslb.com/bfs/album/8456f050ec8639c6e0cef36aba27bfdedc550590.jpg",
- "img_width": 1824,
- "img_height": 840,
- "img_size": 1024
- }],
- "count": 1,
- "ctime": 1582894607,
- "view": 707073,
- "like": 7055
- }, {
- "doc_id": 46853140,
- "poster_uid": 2,
- "title": "",
- "description": "#年度报告# #新年Flag# https://www.bilibili.com/blackboard/timemachine2019.html\n决定了，这就是我的新年Flag！今年我一定要…",
- "pictures": [{
- "img_src": "http://i0.hdslb.com/bfs/album/5b3ae76f79d7cf2501afc3ca7c7da509dcf0e38a.jpg",
- "img_width": 1125,
- "img_height": 2184,
- "img_size": 465
- }, {
- "img_src": "http://i0.hdslb.com/bfs/album/87789fe9644337a1f7e6a0655a32584705af8bda.jpg",
- "img_width": 1125,
- "img_height": 2184,
- "img_size": 421
- }, {
- "img_src": "http://i0.hdslb.com/bfs/album/f752d7f3bb7952f6c0013b3f48ddcb07060b4721.jpg",
- "img_width": 1125,
- "img_height": 2184,
- "img_size": 524
- }, {
- "img_src": "http://i0.hdslb.com/bfs/active/7a52a411bccb716c8e67fe70e6c330d5209346de.jpg",
- "img_width": 1125,
- "img_height": 2184,
- "img_size": 534
- }],
- "count": 4,
- "ctime": 1577966163,
- "view": 833193,
- "like": 5667
- }]
- }
-}
-```
-
-
-
-### 查询用户频道列表
-
-
-
-> http://api.bilibili.com/x/space/channel/list
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----------- | ------ | ---- |
-| mid | num | 目标用户UID | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------ |
-| code | num | 返回值 | 0：成功 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | obj | 信息本体 | 无则为空 |
-
-`data`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ------ | ---------- | ---- |
-| count | num | 总计频道数 | |
-| list | array | 频道列表 | |
-
-`data`中的`list`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | ----------- | --------------------- |
-| 0 | obj | 频道1 | |
-| n | obj | 频道（n+1） | 项数取决于`count`的值 |
-| …… | obj | …… | …… |
-
-`data`中的`list`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ---- | -------------- | -------- |
-| cid | num | 频道ID | |
-| count | num | 频道内含视频数 | |
-| cover | str | 封面图片url | |
-| intro | str | 简介 | 无则为空 |
-| mid | num | 创建用户UID | |
-| mtime | num | 创建时间 | 时间戳 |
-| name | str | 标题 | |
-
-**示例：**
-
-查询用户`UID=53456`的频道列表
-
-http://api.bilibili.com/x/space/channel/list?mid=53456
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "count": 6,
- "list": [{
- "cid": 100249,
- "mid": 53456,
- "name": "【实况】动物之森",
- "intro": "",
- "mtime": 1579898830,
- "count": 2,
- "cover": "http://i1.hdslb.com/bfs/archive/6a7ed9483c34e839dfca981b9e2b94cd4c4efa0a.jpg"
- }, {
- "cid": 79323,
- "mid": 53456,
- "name": "忆雨",
- "intro": "忆雨出现过的视频",
- "mtime": 1562535222,
- "count": 7,
- "cover": "http://i2.hdslb.com/bfs/archive/1783e4f03042b282495799adda1cb56270cea647.jpg"
- }, {
- "cid": 79322,
- "mid": 53456,
- "name": "大画家",
- "intro": "",
- "mtime": 1562535122,
- "count": 6,
- "cover": "http://i0.hdslb.com/bfs/archive/9c85a14e805c6c23cb7a42e1dbef97821bb68960.jpg"
- }, {
- "cid": 77758,
- "mid": 53456,
- "name": "灭火器",
- "intro": "",
- "mtime": 1561270856,
- "count": 4,
- "cover": "http://i2.hdslb.com/bfs/archive/0073208d086b4ebe9cdc540e7664aa74b483aeb6.jpg"
- }, {
- "cid": 75696,
- "mid": 53456,
- "name": "沃玛小剧场",
- "intro": "",
- "mtime": 1559129460,
- "count": 5,
- "cover": "http://i2.hdslb.com/bfs/archive/db2b20ecdb6ed013fc3780b0e741ea88d46b5b40.jpg"
- }, {
- "cid": 170,
- "mid": 53456,
- "name": "爆炸电台",
- "intro": "闲聊的电台",
- "mtime": 1503298893,
- "count": 7,
- "cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg"
- }]
- }
-}
-```
-
-
-
-### 查询用户频道中的视频
-
-> http://api.bilibili.com/x/space/channel/video
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----------- | ------ | --------- |
-| mid | num | 目标用户UID | 必要 | |
-| cid | num | 目标频道ID | 必要 | |
-| pn | num | 页码 | 非必要 | 默认为1 |
-| ps | num | 每页项数 | 非必要 | 默认为100 |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误
-404：无用户对应的频道 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | obj | 信息本体 | |
-
-`data`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ---- | ---- | -------- | ---- |
-| list | obj | 频道信息 | |
-| page | obj | 页面信息 | |
-
-`data`中的`list`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| -------- | ------ | -------------- | -------- |
-| archives | array | 包含的视频列表 | |
-| cid | num | 频道ID | |
-| count | num | 频道内含视频数 | |
-| cover | str | 封面图片url | |
-| intro | str | 简介 | 无则为空 |
-| mid | num | 创建用户UID | |
-| mtime | num | 创建时间 | 时间戳 |
-| name | str | 标题 | |
-
-`list`中的`archives`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | ----------- | --------------------- |
-| 0 | obj | 视频1 | |
-| n | obj | 视频（n+1） | 项数取决于`count`的值 |
-| …… | obj | …… | …… |
-
-`list`中的`archives`数组中的对象：
-
-基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
-
-`data`中的`page`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ---- | ---------- | ---- |
-| count | num | 总计视频数 | |
-| num | num | 当前页码 | |
-| size | num | 每页项数 | |
-
-**示例：**
-
-查询用户`UID=53456`的频道`170`中的视频
-
-http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "list": {
- "cid": 170,
- "mid": 53456,
- "name": "爆炸电台",
- "intro": "闲聊的电台",
- "mtime": 1503298893,
- "count": 7,
- "cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg",
- "archives": [{
- "aid": 87673204,
- "videos": 1,
- "tid": 21,
- "tname": "日常",
- "copyright": 1,
- "pic": "http://i0.hdslb.com/bfs/archive/5387bdcbbe4d5551adbf0ee2e607e4b7d3d8f2f0.jpg",
- "title": "【warma爆炸电台】迟来的自我介绍【第八期】",
- "pubdate": 1581244539,
- "ctime": 1581244540,
- "desc": "时隔半年的新的一期爆炸电台来啦，这是我的一系列杂谈聊天电台，这次因为多了很多新关注的朋友们，所以来做个自我介绍吧！\n画师：Dr-H_喵_ 动画：K_Lacid\n结尾提到的壁纸稍后在动态发原图，动态壁纸在steam那个壁纸软件的创意工坊里搜warma能找到\n\n往期的电台：\n第一期：av6786024 \n第三期：av13619263\n第四期：av18862091\n第五期：av25092410\n第六期：av42492515\n第七期：av62910468",
- "state": 0,
- "attribute": 16512,
- "duration": 2388,
- "rights": {
- "bp": 0,
- "elec": 0,
- "download": 0,
- "movie": 0,
- "pay": 0,
- "hd5": 0,
- "no_reprint": 1,
- "autoplay": 1,
- "ugc_pay": 0,
- "is_cooperation": 0,
- "ugc_pay_preview": 0,
- "no_background": 0
- },
- "owner": {
- "mid": 53456,
- "name": "Warma",
- "face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
- },
- "stat": {
- "aid": 87673204,
- "view": 1383542,
- "danmaku": 88908,
- "reply": 9237,
- "favorite": 32929,
- "coin": 68849,
- "share": 5140,
- "now_rank": 0,
- "his_rank": 52,
- "like": 116164,
- "dislike": 0
- },
- "dynamic": "来做个自我介绍吧！ #warma##沃玛##爆炸电台#",
- "cid": 149793525,
- "dimension": {
- "width": 1920,
- "height": 1080,
- "rotate": 0
- },
- "bvid": "BV1D7411t7Be",
- "inter_video": false
- }, {
- "aid": 62910468,
- "videos": 1,
- "tid": 21,
- "tname": "日常",
- "copyright": 1,
- "pic": "http://i2.hdslb.com/bfs/archive/4bd598f71a144d4505e259b143c0de0bf27968b2.jpg",
- "title": "【warma爆炸电台】居然收到了几千条问题！【第七期】",
- "pubdate": 1565345410,
- "ctime": 1565338559,
- "desc": "时隔半年的爆炸电台第七期终于来啦！在这一期里回答了很多问题，祝看得开心！此外，就在昨天，50万订阅了…真的谢谢大家！\n也欢迎来看往期的电台：\n第一期：av6786024 （2016年10月）\n第二期：av10373352（2017年5月）\n第三期：av13619263（2017年8月）\n第四期：av18862091（2018年1月）\n第五期：av25092410（2018年6月）\n第六期：av42492515（2019年2月）",
- "state": 0,
- "attribute": 16512,
- "duration": 1987,
- "mission_id": 11740,
- "rights": {
- "bp": 0,
- "elec": 0,
- "download": 0,
- "movie": 0,
- "pay": 0,
- "hd5": 0,
- "no_reprint": 1,
- "autoplay": 1,
- "ugc_pay": 0,
- "is_cooperation": 0,
- "ugc_pay_preview": 0,
- "no_background": 0
- },
- "owner": {
- "mid": 53456,
- "name": "Warma",
- "face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
- },
- "stat": {
- "aid": 62910468,
- "view": 455277,
- "danmaku": 19383,
- "reply": 2108,
- "favorite": 10507,
- "coin": 19422,
- "share": 1208,
- "now_rank": 0,
- "his_rank": 0,
- "like": 31515,
- "dislike": 0
- },
- "dynamic": "爆炸电台 第七期 来啦！",
- "cid": 109284065,
- "dimension": {
- "width": 1920,
- "height": 1080,
- "rotate": 0
- },
- "bvid": "BV1gt411K7Ga",
- "inter_video": false
- }]
- },
- "page": {
- "count": 7,
- "num": 1,
- "size": 2
- }
- }
-}
-```
-
-
-
-### 查看用户空间公告
-
-> http://api.bilibili.com/x/space/notice
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----------- | ------ | ---- |
-| mid | num | 目标用户UID | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | --------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | str | 公告信息 | 无则为空 |
-
-**示例：**
-
-查看用户`UID=53456`的空间公告
-
-http://api.bilibili.com/x/space/notice?mid=53456
-
-```json
-{
- "code":0,
- "message":"0",
- "ttl":1,
- "data":"我的微博 @_warma_\n直播录像上传到：warma养鸽场\n头像画师是：微博@Dr-H_喵_\n横幅画师：@薬屋"
-}
-```
-
-
-
-### 查看用户个人TAG
-
-> http://api.bilibili.com/x/space/acc/tags
-
-*请求方式：GET*
-
-上限5条，且内容由用户自定义
-
-带有转义
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----------- | ------ | ---- |
-| mid | num | 目标用户UID | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ------ | -------- | --------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | array | 信息本体 | |
-
-`data`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | -------- | ------------- |
-| 0 | obj | 信息本体 | 只有1项？？？ |
-
-`data`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ---- | ------ | ----------- | ---- |
-| mid | num | 目标用户UID | |
-| tags | array | TAG名称 | |
-
-`data`数组中的对象中的`tags`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | -------- | ------- |
-| 0 | str | TAG1 | |
-| n | str | TAG(n+1) | |
-| …… | str | …… | |
-| 4 | str | TAG5 | 上限5条 |
-
-**示例：**
-
-查看用户`UID=53456`的个人TAG
-
-http://api.bilibili.com/x/space/acc/tags?mid=53456
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": [{
- "mid": 53456,
- "tags": ["\u6e38\u620f", "\u97f3\u4e50", "warma", "\u641e\u7b11", "\u52a8\u753b"]
- }]
-}
-```
-
-
-
-### 查询用户最近玩过的游戏
-
-> http://api.bilibili.com/x/space/lastplaygame
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----------- | ------ | ---- |
-| mid | num | 目标用户UID | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ------------------------------- | -------- | ---------------------------------------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误
53013：用户隐私设置未公开 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | 隐藏时：null
公开时：array | 信息本体 | |
-
-`data`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | --------- | ---------------- |
-| 0 | obj | 游戏1 | |
-| n | obj | 游戏(n+1) | 项数为总计游戏数 |
-| …… | obj | …… | …… |
-
-`data`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | --------------- | ---- |
-| website | str | 游戏主页链接url | |
-| image | str | 游戏图片url | |
-| name | str | 游戏名 | |
-
-**示例：**
-
-查询`UID=2`的最近玩过的游戏
-
- http://api.bilibili.com/x/space/lastplaygame?mid=2
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": [
- {
- "website": "https://game.bilibili.com/fgo/event_meihosou",
- "image": "http://i0.hdslb.com/bfs/game/f7d4ee0877089e4079b8f0b4f5c95dd4ceba512a.png",
- "name": "命运-冠位指定（Fate/GO）"
- },
- {
- "website": "https://game.bilibili.com/pcr/xxtix",
- "image": "http://i0.hdslb.com/bfs/game/7922ecea5cc76fe3c8c177e1d4a6c8cf1c36a700.jpg",
- "name": "公主连结Re:Dive"
- },
- {
- "website": "https://game.bilibili.com/dwbgx/",
- "image": "http://i0.hdslb.com/bfs/game/6d5b2df70dfa987408d8d09110cdc327949885e3.png",
- "name": "大王不高兴"
- },
- {
- "website": "https://game.bilibili.com/bangdream/1stanniversary-yxzx/",
- "image": "http://i0.hdslb.com/bfs/game/4a7d0b7272dffe5a489ee935b6bd2d4f7d5f1257.png",
- "name": "BanG Dream！"
- },
- {
- "website": "http://www.biligame.com/detail/?id=101772",
- "image": "http://i0.hdslb.com/bfs/game/8e8b04e7bd2170c2ba2c9f563a62c72bac2eba2c.jpg",
- "name": "明日方舟"
- }
- ]
-}
-```
-
-
-
-### 查询用户创建的视频收藏夹列表
-
-> http://api.bilibili.com/x/v3/fav/folder/created/list-all
-
-*请求方式：GET*
-
-查看私有收藏夹时需要登录(SESSDATA)
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----------- | ------ | ---- |
-| up_mid | num | 目标用户UID | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ----------------------------- | -------- | --------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | 隐藏时：null
公开时：obj | 信息本体 | |
-
-`data`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ---------------------------------------- | -------------- | ---- |
-| count | num | 创建的收藏夹数 | |
-| list | 无收藏夹时：null
有收藏夹时：array | 收藏夹列表 | |
-
-`data`中的`list`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | ----------- | --------------------- |
-| 0 | obj | 收藏夹1 | |
-| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
-| …… | obj | …… | |
-
-`data`中的`list`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----------- | ---- | ---------------- | ----------------------------------------- |
-| id | num | 收藏夹mlID | |
-| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
-| mid | num | 创建用户UID | |
-| attr | num | 收藏夹属性 | 转换成8-bit二进制处理
详细说明见下表 |
-| title | str | 收藏夹标题 | |
-| fav_state | num | 0 | 作用尚不明确 |
-| media_count | num | 收藏夹总计视频数 | |
-
-`attr`属性二进制值表：
-
-| 其他有待补充... | 1：默认收藏夹 | 0：公开性 |
-| --------------- | -------------------------------- | -------------------- |
-| | 0：默认收藏夹
1：其他收藏夹 | 0：公开
1：私有 |
-
-**示例：**
-
-查询用户`UID=7792521`的收藏夹列表
-
-http://api.bilibili.com/x/v3/fav/folder/created/list-all?up_mid=7792521
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "count": 5,
- "list": [{
- "id": 44233921,
- "fid": 442339,
- "mid": 7792521,
- "attr": 0,
- "title": "默认收藏夹",
- "fav_state": 0,
- "media_count": 85
- }, {
- "id": 936347621,
- "fid": 9363476,
- "mid": 7792521,
- "attr": 22,
- "title": "放假君的鬼畜私房歌",
- "fav_state": 0,
- "media_count": 2
- }, {
- "id": 845218621,
- "fid": 8452186,
- "mid": 7792521,
- "attr": 22,
- "title": "♪一言不合就开唱♪",
- "fav_state": 0,
- "media_count": 4
- }, {
- "id": 844998121,
- "fid": 8449981,
- "mid": 7792521,
- "attr": 22,
- "title": "个人作品精选",
- "fav_state": 0,
- "media_count": 25
- }, {
- "id": 381779121,
- "fid": 3817791,
- "mid": 7792521,
- "attr": 22,
- "title": "鬼畜小课堂",
- "fav_state": 0,
- "media_count": 25
- }]
- }
-}
-```
-
-
-
-### 查询用户收藏的收藏夹
-
-> http://api.bilibili.com/x/v3/fav/folder/collected/list
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ----------- | ------ | ---- |
-| ps | num | 每页项数 | 必要 | |
-| pn | num | 页码 | 必要 | |
-| up_mid | num | 目标用户UID | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
40022：签名过长 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | 隐藏时：null
公开时：obj | 信息本体 | |
-
-`data`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----- | ---------------------------------------- | -------------- | ---- |
-| count | num | 创建的收藏夹数 | |
-| list | 无收藏夹时：null
有收藏夹时：array | 收藏夹列表 | |
-
-`data`中的`list`数组：
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | ----------- | --------------------- |
-| 0 | obj | 收藏夹1 | |
-| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
-| …… | obj | …… | |
-
-`data`中的`list`数组中的对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ----------- | ---- | ------------------ | ----------------------------------------- |
-| id | num | 收藏夹mlID | |
-| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
-| mid | num | 创建用户UID | |
-| attr | num | 收藏夹属性 | 转换成8-bit二进制处理
详细说明见下表 |
-| title | str | 收藏夹标题 | |
-| cover | str | 收藏夹封面图片url | |
-| upper | obj | 收藏夹创建用户信息 | |
-| cover_type | num | 2 | 作用尚不明确 |
-| intro | str | 空 | 作用尚不明确 |
-| ctime | num | 创建时间 | 时间戳 |
-| mtime | num | 审核时间 | 时间戳 |
-| state | num | 0 | 作用尚不明确 |
-| fav_state | num | 0 | 作用尚不明确 |
-| media_count | num | 收藏夹总计视频数 | |
-
-`attr`属性二进制值表：
-
-| 其他有待补充... | 1：默认收藏夹 | 0：公开性 |
-| --------------- | -------------------------------- | -------------------- |
-| | 0：默认收藏夹
1：其他收藏夹 | 0：公开
1：私有 |
-
-`data`中的`list`数组中的对象中的`upper`对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ---- | ---- | ---------- | ------------ |
-| mid | num | 创建人UID | |
-| name | str | 创建人昵称 | |
-| face | str | 空 | 作用尚不明确 |
-
-**示例：**
-
-查询用户`UID=293793435`的收藏夹收藏列表
-
- http://api.bilibili.com/x/v3/fav/folder/collected/list?pn=1&ps=20&up_mid=293793435
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "count": 2,
- "list": [{
- "id": 496307088,
- "fid": 4963070,
- "mid": 412466388,
- "attr": 22,
- "title": "入站必刷",
- "cover": "http://i0.hdslb.com/bfs/archive/baae2b4050363c0ab45465b7cf696b8304fdaca8.jpg",
- "upper": {
- "mid": 412466388,
- "name": "热门菌",
- "face": ""
- },
- "cover_type": 2,
- "intro": "",
- "ctime": 1563394571,
- "mtime": 1563394571,
- "state": 0,
- "fav_state": 0,
- "media_count": 55
- }, {
- "id": 381779121,
- "fid": 3817791,
- "mid": 7792521,
- "attr": 22,
- "title": "鬼畜小课堂",
- "cover": "http://i2.hdslb.com/bfs/archive/09a668cfdb38fb3a85f905c10f48a2947e36a695.jpg",
- "upper": {
- "mid": 7792521,
- "name": "还有一天就放假了",
- "face": ""
- },
- "cover_type": 2,
- "intro": "",
- "ctime": 1553700224,
- "mtime": 1557291666,
- "state": 0,
- "fav_state": 0,
- "media_count": 25
- }]
- }
-}
-```
-
-
-
-
-
-## 设置相关
-
-### 修改个人签名
-
-> http://api.bilibili.com/x/member/web/sign/update
-
-*请求方式：POST*
-
-签名最多支持70个字
-
-修改签名不会立即生效，会等待审核队列稍后生效
-
-需要登录(SESSDATA)
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| --------- | ---- | ------------------------ | ------ | ---------------------- |
-| user_sign | str | 要设置的签名内容 | 非必要 | 删除签名留空或省去即可 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
40022：签名过长 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-
-**示例：**
-
-更新个人标签为`高中技术宅一枚，爱好MC&电子&音乐&数码&编程，资深猿厨`
-
-curl -b "SESSDATA=xxx" -d "user_sign=%E9%AB%98%E4%B8%AD%E6%8A%80%E6%9C%AF%E5%AE%85%E4%B8%80%E6%9E%9A%EF%BC%8C%E7%88%B1%E5%A5%BDMC&%E7%94%B5%E5%AD%90&%E9%9F%B3%E4%B9%90&%E6%95%B0%E7%A0%81&%E7%BC%96%E7%A8%8B%EF%BC%8C%E8%B5%84%E6%B7%B1%E7%8C%BF%E5%8E%A8&csrf=xxx" "http://api.bilibili.com/x/member/web/sign/update"
-
-```json
-{
- "code":0,
- "message":"0",
- "ttl":1
-}
-```
-
-
-
-### 修改用户空间公告
-
-> http://api.bilibili.com/x/space/notice/set
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------------ | ------ | --------------------------------------- |
-| notice | str | 要设置的公告内容 | 非必要 | 删除公告留空或省去即可
少于150字符 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-304：未修改
-400：请求错误（超出长度限制） |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-
-**示例：**
-
-修改个人空间公告为`鸽子`
-
-curl -b "sessdata=xxx" -d "csrf=xxx¬ice=%E9%B8%BD%E5%AD%90" "http://api.bilibili.com/x/space/notice/set"
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1
-}
-```
-
-
-
-### 修改空间隐私权限
-
-> http://space.bilibili.com/ajax/settings/setPrivacy
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-需要验证`DedeUserID`及`DedeUserID__ckMd5`存在且不为0
-
-需要验证`referer`为 `http://.bilibili.com`或`https://.bilibili.com`域名下
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ----------- | ---- | ------------------------ | ------ | ------------------------------ |
-| fav_video | num | 收藏视频 | 非必要 | 0：隐藏
1：公开
下同 |
-| bangumi | num | 追番及追剧 | 非必要 | |
-| tags | num | 关注的TAG | 非必要 | |
-| coins_video | num | 投币的视频 | 非必要 | |
-| user_info | num | 个人信息 | 非必要 | |
-| played_game | num | 玩过的游戏 | 非必要 | |
-| csrf | nstr | CSRF Token（位于cookie） | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------ | ---- | -------- | ----------------------------------- |
-| ststus | bool | 操作结果 | true：操作成功
false：操作失败 |
-| data | str | 错误信息 | 正确时无此项 |
-
-**示例：**
-
-设置`关注的TAG`为隐藏
-
-curl --referer "http://.bilibili.com" -b "SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;" -d "csrf=xxx&tags=0" "http://space.bilibili.com/ajax/settings/setPrivacy"
-
-```json
-{
- "status": true
-}
-```
-
-
-
-### 调整空间板块布局
-
-> http://space.bilibili.com/ajax/settings/setIndexOrder
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-需要验证`DedeUserID`及`DedeUserID__ckMd5`存在且不为0
-
-需要验证`referer`为 `http://.bilibili.com`或`https://.bilibili.com`域名下
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ----------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
-| index_order | nums | 布局列表 | 必要 | 每个值之间用","（%2C）分隔
先左侧布局再右侧布局
值的意义见下表 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
-
-布局参数`index_order`：
-
-| 值 | 含义 |
-| ---- | ---------------------- |
-| 1 | （左侧）我的稿件 |
-| 2 | （左侧）我的收藏夹 |
-| 3 | （左侧）订阅番剧 |
-| 4 | （左侧）订阅标签 |
-| 5 | （左侧）最近投币的视频 |
-| 6 | **作用尚不明确** |
-| 7 | （左侧）我的频道 |
-| 8 | （左侧）我的专栏 |
-| 9 | （左侧）我的相簿 |
-| 21 | （右侧）公告 |
-| 22 | （右侧）直播间 |
-| 23 | （右侧）个人资料 |
-| 24 | （右侧）官方活动 |
-| 25 | （右侧）最近玩的游戏 |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------ | ---- | -------- | ----------------------------------- |
-| ststus | bool | 操作结果 | true：操作成功
false：操作失败 |
-| data | str | 错误信息 | 正确时无此项 |
-
-**示例：**
-
-调整空间布局为：
-
->我的稿件 直播间
->我的专栏 个人资料
->订阅番剧 公告
->我的收藏夹 官方活动
->我的相簿 最近玩的游戏
->最近投币的视频
->订阅标签
->我的频道
-
-curl --referer "http://.bilibili.com" -b "SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;" -d "csrf=xxx&index_order=1%2C8%2C3%2C2%2C9%2C5%2C4%2C7%2C22%2C23%2C21%2C24%2C25%2C6" "http://space.bilibili.com/ajax/settings/setIndexOrder"
-
-```json
-{
- "status": true
-}
-```
-
-
-
-### 修改个人TAG
-
-> http://api.bilibili.com/x/space/acc/tags/set
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-需要验证`DedeUserID`存在且不为0
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
-| tags | strs | 要设置的TAG内容 | 非必要 | 删除公告留空或省去即可
各TAG长度小于10字符
最多5个TAG
各TAG之间用","(%2C)分隔
重复TAG无效 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误（超出长度限制） |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-
-**示例：**
-
-修改个人TAG为`minecraft,技术宅,大佬,小哥哥,可爱`
-
-curl -b "SESSDATA=xxx;DedeUserID=1" -d "csrf=xxx&tags=minecraft%2C%E6%8A%80%E6%9C%AF%E5%AE%85%2C%E5%A4%A7%E4%BD%AC%2C%E5%B0%8F%E5%93%A5%E5%93%A5%2C%E5%8F%AF%E7%88%B1" "http://api.bilibili.com/x/space/acc/tags/set"
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1
-}
-```
-
-
-
-### 添加置顶视频
-
-> http://api.bilibili.com/x/space/top/arc/set
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------------ | ------------ | -------------------------------- |
-| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
-| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
-| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符
默认为空 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-304：未修改
-400：请求错误
53014：稿件已失效
53015：备注过长
53017：置顶非自己的稿件 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-
-**示例：**
-
-置顶视频`av98948772`/`BV1n741127LD`
-
-curl -b "SESSDATA=xxx" -b "aid=98948772&csrf=xxx" "http://api.bilibili.com/x/space/top/arc/set"
-
-同curl -b "SESSDATA=xxx" -b "bvid=BV1n741127LD&csrf=xxx" "http://api.bilibili.com/x/space/top/arc/set"
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1
-}
-```
-
-
-
-### 取消置顶视频
-
-> http://api.bilibili.com/x/space/top/arc/cancel
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------------ | ------ | ---- |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误（重复取消） |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-
-**示例：**
-
-curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/space/top/arc/cancel"
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1
-}
-```
-
-
-
-### 添加代表作视频
-
-> http://api.bilibili.com/x/space/masterpiece/add
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-代表作上限为3个稿件
-
-**正文参数（ application/x-www-form-urlencoded ）：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | ------------------------ | ------------ | -------------------------------- |
-| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
-| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
-| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符
默认为空 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
53014：稿件已失效
53015：备注过长
53017：置顶非自己的稿件
53019：达到上限
53020：已经存在该稿件 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-
-**示例：**
-
-添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表
-
-curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=94916552" "http://api.bilibili.com/x/space/masterpiece/add"
-
-同curl -b "SESSDATA=xxx" -d "csrf=xxx&bvid=BV1ZE411K7ux" "http://api.bilibili.com/x/space/masterpiece/add"
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1
-}
-```
-
-
-
-### 删除代表作视频
-
-> http://api.bilibili.com/x/space/masterpiece/cancel
-
-*请求方式：POST*
-
-需要登录(SESSDATA)
-
-**正文参数（ 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：请求错误
53021：置顶列表中没有该视频 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-
-**示例：**
-
-删除置顶视频`av59765630`/`BV1Yt41137T6`
-
-curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=59765630" "http://api.bilibili.com/x/space/masterpiece/cancel"
-
-同curl -b "SESSDATA=xxx" -d "csrf=xxx&bvid=BV1Yt41137T6" "http://api.bilibili.com/x/space/masterpiece/cancel"
-
diff --git a/user/status_number.md b/user/status_number.md
index 244a0f4..7ef4860 100644
--- a/user/status_number.md
+++ b/user/status_number.md
@@ -19,7 +19,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -36,7 +36,11 @@
查询用户`UID=332704117`的关系状态数
-http://api.bilibili.com/x/relation/stat?vmid=332704117
+```shell
+curl -G 'http://api.bilibili.com/x/relation/stat'\
+--data-urlencode 'vmid=332704117'\
+-b 'SESSDATA=xxx'
+```
```json
{
@@ -53,8 +57,6 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117
}
```
-
-
## UP主状态数
> http://api.bilibili.com/x/space/upstat
@@ -75,7 +77,7 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -102,7 +104,11 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117
查询用户`UID=456664753`的UP主状态数
-http://api.bilibili.com/x/space/upstat?mid=456664753
+```shell
+curl -G 'http://api.bilibili.com/x/space/upstat'\
+--data-urlencode 'mid=456664753'
+```
+
```json
{
"code": 0,
@@ -120,8 +126,6 @@ http://api.bilibili.com/x/space/upstat?mid=456664753
}
```
-
-
## 订阅&投稿状态数
> http://api.bilibili.com/x/space/navnum
@@ -142,7 +146,7 @@ http://api.bilibili.com/x/space/upstat?mid=456664753
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -179,7 +183,12 @@ http://api.bilibili.com/x/space/upstat?mid=456664753
查询用户`UID=239202390`的订阅&投稿状态数
-http://api.bilibili.com/x/space/navnum?mid=239202390
+```shell
+curl -G 'http://api.bilibili.com/x/space/navnum'\
+--data-urlencode 'mid=239202390'\
+-b 'SESSDATA=xxx'
+```
+
```json
{
"code": 0,
@@ -207,8 +216,6 @@ http://api.bilibili.com/x/space/navnum?mid=239202390
}
```
-
-
## 投稿相簿数
> http://api.vc.bilibili.com/link_draw/v1/doc/upload_count
@@ -245,7 +252,10 @@ http://api.bilibili.com/x/space/navnum?mid=239202390
查询用户`UID=53456`的投稿相簿数
-http://api.vc.bilibili.com/link_draw/v1/doc/upload_count?uid=53456
+```shell
+curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/upload_count'\
+--data-urlencode 'uid=53456'
+```
```json
{
diff --git a/video/info.md b/video/info.md
index 3d4e316..85f4177 100644
--- a/video/info.md
+++ b/video/info.md
@@ -23,7 +23,7 @@
| ------- | ---- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -380,7 +380,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
| ------- | ---- | -------- | -------------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
62002：稿件不可见 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | str | 简介内容 | |
**示例：**
@@ -433,7 +433,7 @@ curl -G 'http://api.bilibili.com/x/archive/desc'\
| ------- | ----- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 分P列表 | |
数组`data`：
diff --git a/video/like_coin_fav.md b/video/like_coin_fav.md
index a795f16..654183b 100644
--- a/video/like_coin_fav.md
+++ b/video/like_coin_fav.md
@@ -2,17 +2,17 @@
**本页所有操作均需登录（Cookie或APP）**
-## 操作
-
-### 点赞视频（web端）
+## 点赞
+### 点赞视频（web端）
+
> http://api.bilibili.com/x/web-interface/archive/like
*请求方式：POST*
-认证&鉴权方式：仅可Cookie
+认证方式：仅可Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
@@ -29,13 +29,13 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
65006：已赞过
65004：取消点赞失败 |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
65004：取消点赞失败
65006：重复点赞 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
-为视频`av79677524`/`BV1uJ411r7hL`点赞
+点赞视频`av79677524`/`BV1uJ411r7hL`
avID方式：
@@ -65,15 +65,129 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like'\
}
```
-### 投币视频（web端）
+### 点赞视频（APP端）
+
+> http://app.bilibili.com/x/v2/view/like
+
+*请求方式：POST*
+
+认证方式：仅可APP
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 视频avID | 必要 | |
+| like | num | 操作方式 | 必要 | 0：点赞
1：取消赞 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
10003：不存在该稿件 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 数据本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | ------------ | ---- |
+| toast | str | 提示信息内容 | |
+
+**示例：**
+
+点赞视频`av79677524`
+
+```shell
+curl 'http://app.bilibili.com/x/v2/view/like'\
+--data-urlencode 'access_key=xxx'\
+--data-urlencode 'aid=79677524'\
+--data-urlencode 'like=0'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "toast": "点赞收到！视频可能推荐哦"
+ }
+}
+```
+
+### 判断视频是否被点赞（双端）
+
+> http://api.bilibili.com/x/web-interface/archive/has/like
+
+*请求方式：GET*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ------------ | ------------------ |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | ---------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | num | 被点赞标志 | 0：未点赞
1：已点赞 |
+
+**示例：**
+
+视频`av39330059`/`BV1Bt411z799`的状态为已点赞
+
+avID方式：
+
+```shell
+curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like'\
+--data-urlencode 'aid=39330059'\
+-b 'SESSDATA=xxx'
+```
+
+bvID方式：
+
+```shell
+curl -G 'api.bilibili.com/x/web-interface/archive/has/like'\
+--data-urlencode 'bvid=BV1Bt411z799'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": 1
+}
+```
+
+## 投币
+
+### 投币视频（web端）
+
> http://api.bilibili.com/x/web-interface/coin/add
*请求方式：POST*
-认证&鉴权方式：仅可Cookie
+认证方式：仅可Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
@@ -81,8 +195,8 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like'\
| ----------- | ---- | ------------------------ | ------------ | --------------------------------------- |
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
-| select_like | num | 附加点赞 | 非必要 | 0：不点赞
1：同时点赞
默认为0 |
| multiply | num | 投币数量 | 必要 | 上限为2 |
+| select_like | num | 是否附加点赞 | 非必要 | 0：不点赞
1：同时点赞
默认为0 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@@ -91,9 +205,9 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like'\
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-104：硬币不足
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
34002：不能给自己投币
34003：非法的投币数量
34005：超过投币上限 |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-104：硬币不足
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
34002：不能给自己投币
34003：非法的投币数量
34004：投币间隔太短
34005：超过投币上限 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
@@ -104,8 +218,6 @@ data 对象：
**示例：**
-
-
为视频`av90671873`/`BV1N7411A7wC`投币2枚
avID方式：
@@ -119,6 +231,8 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add'\
-b 'SESSDATA=xxx'
```
+bvID方式：
+
```shell
curl 'http://api.bilibili.com/x/web-interface/coin/add'\
--data-urlencode 'bvid=BV1N7411A7wC'\
@@ -139,25 +253,22 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add'\
}
```
-### 收藏视频（暂不支持bvID）
+### 投币视频（APP端）
-
-
-> http://api.bilibili.com/medialist/gateway/coll/resource/deal
+> http://app.bilibili.com/x/v2/view/coin/add
*请求方式：POST*
-需要验证`referer`为 `.bilibili.com`域名下
+认证方式：仅可APP
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------------- | ---- | ------------------------ | ------ | ------------------------------ |
-| rid | num | 视频avID | 必要 | |
-| type | num | 必须为2 | 必要 | |
-| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
-| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------ | ----------- | --------------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 视频avID | 必要 | |
+| multiply | num | 投币数量 | 必要 | 上限为2 |
+| select_like | num | 附加点赞 | 非必要 | 0：不点赞
1：同时点赞
默认为0 |
**json回复：**
@@ -165,7 +276,136 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add'\
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-403：访问权限不足
10003：不存在该稿件
11201：已经收藏过了
11202：已经取消收藏了
72010017：参数错误 |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-104：硬币不足
-400：请求错误
10003：不存在该稿件
34002：不能给自己投币
34003：非法的投币数量
34004：投币间隔太短
34005：超过投币上限 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+data 对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ------------ | ----------------------------------------------------- |
+| like | bool | 是否点赞成功 | true：成功
false：失败
已赞过则附加点赞失败 |
+
+为视频`av90671873`投币2枚
+
+```shell
+curl 'http://app.bilibili.com/x/v2/view/coin/add'\
+--data-urlencode 'access_key=xxx'\
+--data-urlencode 'aid=90671873'\
+--data-urlencode 'select_like=1'\
+--data-urlencode 'multiply=2'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "like": true
+ }
+}
+```
+
+### 判断视频是否被投币（双端）
+
+> http://api.bilibili.com/x/web-interface/archive/coins
+
+*请求方式：GET*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ------------ | ------------------ |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
+| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | -------- | --------- |
+| multiply | num | 投币枚数 | 未投币为0 |
+
+**示例：**
+
+视频`av37896701`/`BV18t411q7zz`的投币数为2枚
+
+avID方式：
+
+```shell
+curl -G 'api.bilibili.com/x/web-interface/archive/coins'\
+--data-urlencode 'aid=37896701'\
+-b 'SESSDATA=xxx'
+```
+
+bvID方式：
+
+```shell
+curl -G 'api.bilibili.com/x/web-interface/archive/coins'\
+--data-urlencode 'bvid=BV18t411q7zz'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "multiply": 2
+ }
+}
+```
+
+## 收藏
+
+
+
+### 收藏视频（双端）
+
+> http://api.bilibili.com/medialist/gateway/coll/resource/deal
+>
+> http://api.bilibili.com/x/v3/fav/resource/deal
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+鉴权方式：Cookie方式时需要验证referer为 `.bilibili.com`域名下
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------------- | ---- | ------------------------ | -------------- | ------------------------------ |
+| access_key | str | APP登录Token | APP方式必要 | |
+| rid | num | 视频avID | 必要 | |
+| type | num | 必须为2 | 必要 | |
+| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
+| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
+| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-403：访问权限不足
10003：不存在该稿件
11201：已经收藏过了
11202：已经取消收藏了
11203：达到收藏上限
72010017：参数错误 |
| message | str | 错误信息 | 正确为success |
| data | obj | 信息本体 | |
@@ -179,6 +419,8 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add'\
将视频`av49166435`添加到收藏夹`49166435`中
+Cookie方式：
+
```shell
curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\
--data-urlencode 'rid=90671873'\
@@ -186,10 +428,21 @@ curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\
--data-urlencode 'add_media_ids=49166435'\
--data-urlencode 'del_media_ids='\
--data-urlencode 'csrf=xxx'\
--b 'SESSDATA=xxx'
+-b 'SESSDATA=xxx'\
-e 'https://www.bilibili.com'
```
+APP方式：
+
+```shell
+curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\
+--data-urlencode 'access_key=xxx'\
+--data-urlencode 'rid=90671873'\
+--data-urlencode 'type=2'\
+--data-urlencode 'add_media_ids=49166435'\
+--data-urlencode 'del_media_ids='
+```
+
```json
{
"code": 0,
@@ -200,14 +453,83 @@ curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\
}
```
-### 一键三连视频（web端）
+### 判断视频是否被收藏（双端）
+
+> http://api.bilibili.com/x/v2/fav/video/favoured
+
+*请求方式：GET*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | -------- | ------------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num或str | 视频avID或视频bvID | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+data 对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | -------- | ------------------------------- |
+| count | num | 1 | 作用尚不明确 |
+| favoured | bool | 是否收藏 | true：已收藏
false：未收藏 |
+
+**示例：**
+
+视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏
+
+avID方式：
+
+```shell
+curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured'\
+--data-urlencode 'aid=46281123'\
+-b 'SESSDATA=xxx'
+```
+
+bvID方式：
+
+```shell
+curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured'\
+--data-urlencode 'aid=BV1Bb411H7Dv'\
+-b 'SESSDATA=xxx'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "count": 1,
+ "favoured": true
+ }
+}
+```
+
+## 一键三连
+### 一键三连视频（web端）
+
> http://api.bilibili.com/x/web-interface/archive/like/triple
*请求方式：POST*
+认证方式：仅可Cookie（SESSDATA）
+
同时点赞投币收藏视频，收藏于默认收藏夹中
**正文参数（ application/x-www-form-urlencoded ）：**
@@ -226,7 +548,7 @@ curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -274,187 +596,50 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like/triple'\
}
```
-## 判断状态
+### 一键三连视频（APP端）
-### 视频是否被点赞
+> http://app.bilibili.com/x/v2/view/like/triple
-
+*请求方式：POST*
-> http://api.bilibili.com/x/web-interface/archive/has/like
+认证方式：仅可APP
-*请求方式：GET*
+同时点赞投币收藏视频，收藏于默认收藏夹中
-**url参数：**
+**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------------ | ------------------ |
-| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 视频avID | 必要 | |
**json回复：**
根对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | ---------- | ------------------------------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | num | 被点赞标志 | 0：未点赞
1：已点赞 |
-
-**示例：**
-
-视频`av39330059`/`BV1Bt411z799`的状态为已点赞
-
-avID方式：
-
-```shell
-curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like'\
---data-urlencode 'aid=39330059'\
--b 'SESSDATA=xxx'
-```
-
-bvID方式：
-
-```shell
-curl -G 'api.bilibili.com/x/web-interface/archive/has/like'\
---data-urlencode 'bvid=BV1Bt411z799'\
--b 'SESSDATA=xxx'
-```
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": 1
-}
-```
-
-### 视频是否被投币
-
-
-
-> http://api.bilibili.com/x/web-interface/archive/coins
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | ---- | -------- | ------------ | ------------------ |
-| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
-| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | obj | 信息本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
10003：不存在该稿件 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
`data`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| -------- | ---- | -------- | --------- |
-| multiply | num | 投币枚数 | 未投币为0 |
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | ------------ | --------------------------- |
+| like | bool | 是否点赞成功 | true：成功
false：失败 |
+| coin | bool | 是否投币成功 | true：成功
false：失败 |
+| fav | bool | 是否收藏成功 | true：成功
false：失败 |
+| multiply | num | 投币枚数 | 默认为2 |
**示例：**
-视频`av37896701`/`BV18t411q7zz`的投币数为2枚
-
-avID方式：
+将视频`av91003840`一键三连
```shell
-curl -G 'api.bilibili.com/x/web-interface/archive/coins'\
---data-urlencode 'aid=37896701'\
--b 'SESSDATA=xxx'
-```
-
-bvID方式：
-
-```shell
-curl -G 'api.bilibili.com/x/web-interface/archive/coins'\
---data-urlencode 'bvid=BV18t411q7zz'\
--b 'SESSDATA=xxx'
-```
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "multiply": 2
- }
-}
-```
-
-### 视频是否被收藏
-
-
-
-> http://api.bilibili.com/x/v2/fav/video/favoured
-
-*请求方式：GET*
-
-**url参数：**
-
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------ | -------- | ------------------ | ------ | ---- |
-| aid | num或str | 视频avID或视频bvID | 必要 | |
-
-**json回复：**
-
-根对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------- |
-| code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
-| data | obj | 信息本体 | |
-
-data 对象：
-
-| 字段 | 类型 | 内容 | 备注 |
-| -------- | ---- | -------- | ------------------------------- |
-| count | num | 1 | 作用尚不明确 |
-| favoured | bool | 是否收藏 | true：已收藏
false：未收藏 |
-
-**示例：**
-
-视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏
-
-avID方式：
-
-```shell
-curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured'\
---data-urlencode 'aid=46281123'\
--b 'SESSDATA=xxx'
-```
-
-bvID方式：
-
-```shell
-curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured'\
---data-urlencode 'aid=BV1Bb411H7Dv'\
--b 'SESSDATA=xxx'
-```
-
-```json
-{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "count": 1,
- "favoured": true
- }
-}
+curl 'http://app.bilibili.com/x/v2/view/like/triple'\
+--data-urlencode 'access_key=xxx'\
+--data-urlencode 'aid=91003840'
```
diff --git a/video/pbp.md b/video/pbp.md
index 3b189d5..1fe0efc 100644
--- a/video/pbp.md
+++ b/video/pbp.md
@@ -45,7 +45,10 @@
获取视频`CID=3724723`的获取弹幕趋势顶点列表
-http://api.bilibili.com/pbp/data?cid=3724723
+```shell
+curl -G 'http://api.bilibili.com/pbp/data'\
+--data-urlencode 'cid=3724723'
+```
```json
{
diff --git a/video/recommend.md b/video/recommend.md
index 12edf19..644fc90 100644
--- a/video/recommend.md
+++ b/video/recommend.md
@@ -23,7 +23,7 @@
| ------- | ------ | -------- | ---------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | 推荐列表 | |
`data`数组：
@@ -43,9 +43,19 @@
查询视频`av7`/`BV1xx411c7m9`的推荐视频列表
-http://api.bilibili.com/x/web-interface/archive/related?aid=7
+avID方式：
-同http://api.bilibili.com/x/web-interface/archive/related?bvid=BV1xx411c7m9
+```shell
+curl -G 'http://api.bilibili.com/x/web-interface/archive/related'\
+--data-urlencode 'aid=7'
+```
+
+bvID方式：
+
+```shell
+curl -G 'http://api.bilibili.com/x/web-interface/archive/related'\
+--data-urlencode 'bvid=BV1xx411c7m9'
+```
```json
{
diff --git a/video/report.md b/video/report.md
index 61e4c7a..7a0ad31 100644
--- a/video/report.md
+++ b/video/report.md
@@ -2,20 +2,24 @@
**本页所有操作均需登录（Cookie或APP）**
-## 上报观看进度（APP端）（暂不支持bvID）
+## 上报观看进度（APP端）
> http://api.bilibili.com/x/v2/history/report
*请求方式：POST*
+认证方式：APP或Cookie（SESSDATA）
+
**正文参数（ application/x-www-form-urlencoded ）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| -------- | ---- | ------------------------ | ------ | --------------------- |
-| aid | num | 视频avID | 必要 | |
-| cid | num | 视频CID | 必要 | 用于识别分P |
-| progress | num | 观看进度 | 非必要 | 单位为秒
默认为0 |
-| csrf | str | CSRF Token（位于cookie） | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------------------ | -------------- | --------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 视频avID | 必要 | |
+| cid | num | 视频CID | 必要 | 用于识别分P |
+| progress | num | 观看进度 | 非必要 | 单位为秒
默认为0 |
+| platform | str | 平台标识 | 非必要 | 可为android |
+| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@@ -25,13 +29,35 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
记录视频`av13662970`（`CID=126654047`）的观看记录位于`1248`秒
-curl -b "SESSDATA=xxx" -d "aid=13662970&cid=126654047&progress=1248&csrf=xxx" "http://api.bilibili.com/x/v2/history/report"
+Cookie方式：
+
+```shell
+curl 'http://api.bilibili.com/x/v2/history/report'\
+--data-urlencode 'aid=13662970'\
+--data-urlencode 'cid=126654047'\
+--data-urlencode 'progress=1248'\
+--data-urlencode 'platform=android'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
+
+APP方式：
+
+```shell
+curl 'http://api.bilibili.com/x/v2/history/report'\
+--data-urlencode 'access_key=xxx'\
+--data-urlencode 'aid=13662970'\
+--data-urlencode 'cid=126654047'\
+--data-urlencode 'progress=1248'\
+--data-urlencode 'platform=android'
+```
+
```json
{
@@ -41,14 +67,14 @@ 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*
+认证方式：仅可Cookie（SESSDATA）
+
默认间隔15秒一次
亦可记录播放历史
@@ -80,13 +106,26 @@ curl -b "SESSDATA=xxx" -d "aid=13662970&cid=126654047&progress=1248&csrf=xxx" "h
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| 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
+```shell
+curl 'api.bilibili.com/x/click-interface/web/heartbeat'\
+--data-urlencode 'aid=2'\
+--data-urlencode 'bvid=BV1xx411c7mD'\
+--data-urlencode 'cid=62131'\
+--data-urlencode 'played_time=60'\
+--data-urlencode 'realtime=60'\
+--data-urlencode 'start_ts=1592720840'\
+--data-urlencode 'type=3'\
+--data-urlencode 'dt=2'\
+--data-urlencode 'play_type=0'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
```json
{
diff --git a/video/snapshot.md b/video/snapshot.md
index f6d2e7d..a303f88 100644
--- a/video/snapshot.md
+++ b/video/snapshot.md
@@ -6,7 +6,7 @@
截取时间表的时间和快照一一对应，并按照从左到右 从上到下的顺序排布
-## 获取视频快照1（用于进度条预览）
+## 获取视频快照（web端）
> http://api.bilibili.com/x/player/videoshot
*请求方式：GET*
@@ -28,7 +28,7 @@
| ------- | ---- | -------- | ------------------------------------------------ |
| code | num | 返回值 | 0：成功
40001：请求错误
40003：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -62,9 +62,23 @@
**示例：**
-http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
+获取视频`av26273789`/`BV1os411H7wm`的快照
-同http://api.bilibili.com/x/player/videoshot?bvid=BV1os411H7wm&index=1
+avID方式：
+
+```shell
+curl -G 'http://api.bilibili.com/x/player/videoshot'\
+--data-urlencode 'aid=26273789'\
+--data-urlencode 'index=1'
+```
+
+bvID方式：
+
+```shell
+curl -G 'http://api.bilibili.com/x/player/videoshot'\
+--data-urlencode 'bvid=BV1os411H7wm'\
+--data-urlencode 'index=1'
+```
```json
{
@@ -83,15 +97,93 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
}
```
+## 获取视频快照（APP端）
+> http://app.bilibili.com/x/v2/view/video/shot
-## 获取视频快照2 （用于封面预览 暂不支持bvID）
+*请求方式：GET*
+
+鉴权方式：appkey
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ---------- | ----------- | ---- |
+| aid | num | 视频avID | 必要 | |
+| cid | num | 分P CID | 必要 | |
+| appkey | str | APP密钥 | APP方式必要 | |
+| ts | num | 当前时间戳 | APP方式必要 | |
+| sign | str | APP签名 | APP方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-3：API校验密匙错误
-400：请求错误
10008：稿件的缩略图不存在 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ----- | -------------------- | --------- |
+| pvdata | str | bin格式截取时间表url | |
+| img_x_len | num | 每行图片数 | 一般为10 |
+| img_y_len | num | 每列图片数 | 一般为10 |
+| img_x_size | num | 每张图片长 | 一般为160 |
+| img_y_size | num | 每张图片宽 | 一般为90 |
+| image | array | 图片拼版 | |
+
+`data`中的`image`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ----------------- | -------------------------- |
+| 0 | str | 图片拼版1 url | |
+| n | str | 图片拼版(n+1) url | 第一张拼版占满时延续第二张 |
+| …… | str | …… | …… |
+
+示例：
+
+获取视频`av26273789`（`CID=49075258`）的快照
+
+```shell
+curl -G 'http://app.bilibili.com/x/v2/view/video/shot'\
+--data-urlencode 'aid=26273789'
+--data-urlencode 'cid=49075258'
+--data-urlencode 'appkey=1d8b6e7d45233436'
+--data-urlencode 'ts=0'
+--data-urlencode 'sign=06c0a4f2ede21984313552bd9439db18'
+```
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "pvdata": "http://i0.hdslb.com/bfs/videoshot/49075258.bin",
+ "img_x_len": 10,
+ "img_y_len": 10,
+ "img_x_size": 160,
+ "img_y_size": 90,
+ "image": [
+ "http://i0.hdslb.com/bfs/videoshot/49075258.jpg",
+ "http://i0.hdslb.com/bfs/videoshot/49075258-1.jpg"
+ ]
+ }
+}
+```
+
+## 获取视频快照（web端）（用于封面预览）
> http://api.bilibili.com/pvideo
*请求方式：GET*
-内容与「获取视频快照1」加参数「index」=1相同，但url带有转义，仅限第1P
+内容与「获取视频快照1」加参数index=1相同，但url带有转义，仅限第1P
**url参数：**
@@ -107,7 +199,7 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
| ------- | ---- | -------- | ---------------------------------------------- |
| code | num | 返回值 | 0：成功
40001：请求错误
-404：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -141,7 +233,12 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
**示例：**
-http://api.bilibili.com/pvideo?aid=26273789
+获取视频`av26273789`的快照
+
+```shell
+curl -G 'http://api.bilibili.com/pvideo'\
+--data-urlencode 'aid=26273789'
+```
```json
{
diff --git a/video/status_number.md b/video/status_number.md
index c9d63b7..a2a2ad3 100644
--- a/video/status_number.md
+++ b/video/status_number.md
@@ -19,7 +19,7 @@
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功
40001：请求错误
40003：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -74,8 +74,6 @@ curl -G 'http://api.bilibili.com/archive_stat/stat'\
}
```
-
-
## 视频状态数2（禁python）
> http://api.bilibili.com/x/web-interface/archive/stat
@@ -99,7 +97,7 @@ curl -G 'http://api.bilibili.com/archive_stat/stat'\
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功
-400：请求错误
-412：请求被拦截
40003：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
diff --git a/video/tags.md b/video/tags.md
index e5cb381..5526e80 100644
--- a/video/tags.md
+++ b/video/tags.md
@@ -2,7 +2,7 @@
## 获取视频TAG信息
-> http://https://api.bilibili.com/x/tag/archive/tags
+> http://api.bilibili.com/x/tag/archive/tags
*请求方式：GET*
@@ -21,7 +21,7 @@
| ------- | ------ | -------- | ---------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | array | TAG列表 | 无TAG为空 |
`data`数组：
@@ -65,9 +65,21 @@
查询视频`av89772773`/`BV1M741177Kg`的TAG
-http://api.bilibili.com/x/tag/archive/tags?aid=89772773
+avID方式：
-同http://api.bilibili.com/x/tag/archive/tags?bvid=BV1M741177Kg
+```shell
+curl -G 'http://api.bilibili.com/x/tag/archive/tags'\
+--data-urlencode 'aid=89772773'\
+-b 'SESSDATA=xxx'
+```
+
+bvID方式：
+
+```shell
+curl -G 'http://api.bilibili.com/x/tag/archive/tags'\
+--data-urlencode 'bvid=BV1M741177Kg'\
+-b 'SESSDATA=xxx'
+```
```json
{
@@ -183,9 +195,7 @@ http://api.bilibili.com/x/tag/archive/tags?aid=89772773
}
```
-
-
-## 点赞&取消点赞视频TAG（暂不支持bvID）
+## 点赞&取消点赞视频TAG
> http://api.bilibili.com/x/tag/archive/like2
@@ -193,7 +203,7 @@ http://api.bilibili.com/x/tag/archive/tags?aid=89772773
需要登录(SESSDATA)
-重复访问为取消
+重复请求为取消
**正文参数（ application/x-www-form-urlencoded ）：**
@@ -211,13 +221,19 @@ http://api.bilibili.com/x/tag/archive/tags?aid=89772773
| ------- | ---- | -------- | ---------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
-为视频`av89772773`的TAG`TAGID=12620189`点赞
+为视频`av89772773`的TAG`12620189`点赞
-curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=12620189" "http://api.bilibili.com/x/tag/archive/like2"
+```shell
+curl 'http://api.bilibili.com/x/tag/archive/like2'\
+--data-urlencode 'aid=89772773'\
+--data-urlencode 'tag_id=12620189'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
```json
{
@@ -227,9 +243,7 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=12620189" "http://api.bi
}
```
-
-
-## 点踩&取消点踩视频TAG（暂不支持bvID）
+## 点踩&取消点踩视频TAG
> http://api.bilibili.com/x/tag/archive/hate2
@@ -255,13 +269,19 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=12620189" "http://api.bi
| ------- | ---- | -------- | ---------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
**示例：**
-为视频`av89772773`的TAG`TAGID=7520816`点踩
+为视频`av89772773`的TAG`7520816`点踩
-curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=7520816" "http://api.bilibili.com/x/tag/archive/hate2"
+```shell
+curl 'http://pi.bilibili.com/x/tag/archive/hate2'\
+--data-urlencode 'aid=89772773'\
+--data-urlencode 'tag_id=7520816'\
+--data-urlencode 'csrf=xxx'\
+-b 'SESSDATA=xxx'
+```
```json
{
diff --git a/video/video_zone.md b/video/video_zone.md
index 52f7c41..bb1998a 100644
--- a/video/video_zone.md
+++ b/video/video_zone.md
@@ -88,7 +88,7 @@
| 音游 | music | 136 | 各个平台上，通过配合音乐与节奏而进行的音乐类游戏视频 | [/v/game/music](https://www.bilibili.com/v/game/music) |
| Mugen | mugen | 19 | 以Mugen引擎为平台制作、或与Mugen相关的游戏视频 | [/v/game/mugen](https://www.bilibili.com/v/game/mugen) |
-## 知识~~（原科技分区）~~
+## 知识（~~原科技分区~~）
**已改版**
@@ -98,7 +98,7 @@
| ----------------------------- | ----------------- | ---- | --------------------------------------------------------- | ------------------------------------------------------------ |
| 知识（主分区） | technology | 36 | | [/v/technology](https://www.bilibili.com/v/technology) |
| 科学科普 | science | 201 | 回答你的十万个为什么 | [/v/technology/science](https://www.bilibili.com/v/technology/science) |
-| 社科人文~~（趣味科普人文）~~ | fun | 124 | 聊聊财经/社会/法律，看看历史趣闻，品品人文艺术 | [/v/technology/fun](https://www.bilibili.com/v/technology/fun) |
+| 社科人文（~~趣味科普人文~~） | fun | 124 | 聊聊财经/社会/法律，看看历史趣闻，品品人文艺术 | [/v/technology/fun](https://www.bilibili.com/v/technology/fun) |
| 财经 | finance | 207 | 宏观经济分析，证券市场动态，商业帝国故事，知识与财富齐飞~ | [/v/technology/finance](https://www.bilibili.com/v/technology/finance) |
| 校园学习 | campus | 208 | 老师很有趣，同学多人才，我们都爱搞学习 | [/v/technology/campus](https://www.bilibili.com/v/technology/campus) |
| 职业职场 | career | 209 | 职场加油站，成为最有料的职场人 | [/v/technology/career](https://www.bilibili.com/v/technology/career) |
diff --git a/video/videostream_url.md b/video/videostream_url.md
index 0d3cc23..76e3da1 100644
--- a/video/videostream_url.md
+++ b/video/videostream_url.md
@@ -49,7 +49,7 @@
| ------- | ----------------------------- | -------- | ---------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频 |
| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | 有效时：obj
无效时：null | 数据本体 | |
`data`对象：
@@ -269,7 +269,7 @@ curl -G 'http://api.bilibili.com/x/player/playurl'\
将`data`.`durl`.`[1-n]`.`url`或`data`.`durl`.`[1-n]`.`backup_url`.`[0]`中的内容作为url进行GET操作, 如果有多个视频, 需要手动合并处理
-需要验证Header中`referer`在 `http://www.bilibili.com`或`https://www.bilibili.com`域名下
+需要验证请求Header中`referer`为 `.bilibili.com`域名下（防盗链）
**无referer或错误的情况会返回403 Forbidden**故无法获取