github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-01-14 05:40:07 +08:00
Code Issues Packages Projects Releases Wiki Activity

继续修改文档格式 并添加频道相关

Browse Source
This commit is contained in:
SocialSisterYi 2020-07-17 23:50:28 +08:00
parent f272277d22
commit 05ca6b603a
51 changed files with 2582 additions and 1931 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@ -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
成品：

2
article/info.md
View File

@ -20,7 +20,7 @@
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此信息 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

4
article/like_coin_fav.md
View File

@ -26,7 +26,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />65006：已赞过<br />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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34005：超过投币上限 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：

17
blackroom/banlist.md
View File

@ -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：成功<br />-400：请求错误<br />-404：无此信息 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

8
broadcast/general.md → broadcast/readme.md
View File

@ -1,5 +1,9 @@
# 全站广播
可用的广播服务：
- [视频实时信息](video_room.md)√
## 获取广播服务器地址
> http://api.bilibili.com/x/web-interface/broadcast/servers
@ -20,7 +24,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@ -109,8 +113,6 @@
}
```
## 服务器数据包
连接服务器分为三种方式，分别是ws wss tcp，数据包分为上行和下行

8
broadcast/video_room.md
View File

@ -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：**

2
cheese/videostream_url.md
View File

@ -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**故无法获取

34
comment/action.md
View File

@ -28,9 +28,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12015：需要评论验证码<br />12016：评论内容包含敏感信息<br />12025：评论字数过多<br />12035：该账号被UP主列入评论黑名单<br />12051：重复评论，请勿刷屏<br />**（其他错误码有待补充）** |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12001：已经存在评论主题<br />12002：评论区已关闭<br />12003：禁止回复<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12015：需要评论验证码<br />12016：评论内容包含敏感信息<br />12025：评论字数过多<br />12035：该账号被UP主列入评论黑名单<br />12051：重复评论，请勿刷屏<br />**（其他错误码有待补充）** |
| message | str | 错误信息 | <br /> |
| 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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12004：禁止操作 赞或踩<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** |
| 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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12004：禁止操作 赞或踩<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** |
| 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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-403：权限不足<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12029：已经有置顶评论<br />12030：不能置顶非一级评论<br />**（其他错误码有待补充）** |
| 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：自定义备注<br />1：垃圾广告<br />2：色情<br />4：引战<br />5：剧透<br />7：人身攻击<br />8：内容不相关<br />9：违法违规<br />10：低俗<br />12：赌博诈骗<br />15：侵犯隐私<br />16：抢楼<br />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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-403：权限不足<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12008：已经举报过了<br />12009：评论主体的type不合法<br />12019：举报过于频繁<br />**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
**示例：**

46
comment/comment_list.md
View File

@ -1,4 +1,4 @@
# 评论区明细
# 点评评论区明细
<img src="/imgs/comment.svg" width="100" height="100"/>
@ -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：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
@ -2348,7 +2357,7 @@
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：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：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：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：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：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：成功<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | -------------- | ---------------- |
@ -7003,8 +7019,6 @@ data`对象：
}
```
## 获取评论区评论总数（APP端）
> http://api.bilibili.com/x/v2/reply/count
@ -7026,7 +7040,7 @@ data`对象：
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无此项<br />12009：评论主体的type不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 数据本体 | |
`data`对象：
@ -7053,8 +7067,6 @@ http://api.bilibili.com/x/v2/reply/count?type=1&oid=2
```
## 附表-评论条目对象
| 字段 | 类型 | 内容 | 备注 |

6
creativecenter/railgun.md
View File

@ -18,7 +18,7 @@
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-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：成功<br />-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：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

16
danmaku/action.md
View File

@ -31,9 +31,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />36702：弹幕长度大于100<br />36703：发送频率过快<br />36709：您的等级不足，不能发送高级弹幕<br />36710：您的权限不足，不能发送这种样式的弹幕<br />36711：该视频禁止发送弹幕<br />36714：弹幕出现时刻超过视频总时长<br />**（其他错误码有待补充）** |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />36700：系统升级中<br />36701：弹幕包含被禁止的内容<br />36702：弹幕长度大于100<br />36703：发送频率过快<br />36704：禁止向未审核的视频发送弹幕<br />36705：您的等级不足，不能发送弹幕<br />36706：您的等级不足，不能发送顶端弹幕<br />36707：您的等级不足，不能发送底端弹幕<br />36708：您的等级不足，不能发送彩色弹幕<br />36709：您的等级不足，不能发送高级弹幕<br />36710：您的权限不足，不能发送这种样式的弹幕<br />36711：该视频禁止发送弹幕<br />36712：level 1用户发送弹幕的最大长度为20<br />36713：稿件未付费<br />36714：弹幕发送时间不合法<br />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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />36301：撤回失败，弹幕发送已过2分钟<br />36302：撤回失败，弹幕已经被删除或撤回<br />36303：撤回失败，今天撤回的机会已经用完<br />**（其他错误码有待补充）** |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />36301：撤回失败，弹幕发送已过2分钟<br />36302：撤回失败，弹幕已经被删除或撤回<br />36303：撤回失败，今天撤回的机会已经用完<br />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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-107：硬币不足<br />-400：请求错误<br />36010：已购买 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-107：硬币不足<br />-400：请求错误<br />36007：不允许购买<br />36009：正在确认中<br />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：成功<br />-101：账号未登录<br />--400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | 有效时：obj<br />无效时：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：同意<br />2：未同意<br />未购买时无此项 |
| accept | bool | 是否允许申请 | |
| accept | bool | 是否允许申请 | true：允许<br />false：不允许 |
| hasBuy | bool | 是否已购买 | true：已购买<br />未购买时无此项 |
**示例：**

2
danmaku/history.md
View File

@ -24,7 +24,7 @@
| ------- | ------------------------------- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | 有弹幕：array<br />无弹幕：null | 日期列表 | |
`data`数组：

2
danmaku/snapshot.md
View File

@ -22,7 +22,7 @@
| ------- | ----- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无视频 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | array | 预览列表 | |
`data`数组：

2
electric/Bcoin.md
View File

@ -28,7 +28,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功（并不代表充电成功） <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

4
electric/WeChat&Alipay.md
View File

@ -41,7 +41,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-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：成功<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

2
electric/charge_list.md
View File

@ -153,7 +153,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无视频<br />62001：不需要展示充电信息 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

2
electric/charge_msg.md
View File

@ -22,7 +22,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />88203：不能重复留言 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
**示例：**

4
emote/action.md
View File

@ -26,7 +26,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-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：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403：访问权限不足 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
**示例：**

6
emote/emote_list.md
View File

@ -22,7 +22,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@ -228,7 +228,7 @@
| ------- | ----------------------------- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | 有效时：obj<br />无效时：null | 信息本体 | |
`data`对象：
@ -515,7 +515,7 @@
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

12
history&toview/history.md
View File

@ -27,7 +27,7 @@
| ------- | ----- | ------------ | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | array | 历史记录列表 | |
`data`对象：
@ -356,7 +356,7 @@
| ------- | ------ | ------------ | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-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：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-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：成功<br />-101：账号未登录<br />-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：成功<br />-101：账号未登录<br />-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：成功<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | bool | 停用状态 | true：停用<br />false：正常 |
**示例：**

8
history&toview/toview.md
View File

@ -28,7 +28,7 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />90001：列表已满<br />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：成功<br />-101：账号未登录<br />-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：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-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：成功<br />-101：账号未登录<br />-111：csrf校验失败 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
**示例：**

6
imgs/home.svg Normal file
View File

@ -0,0 +1,6 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024">
<path fill="#29B28A" d="M632.4,855h35c60.4,0,112-51,112-112V518c1.3-32,24-54.7,56-56h4
c21.3,0,37.3-13,44-33c4-17.3-1-33.7-13-47l-349-349c-46.7-44-112.3-44-159,0l-349,349c-14.7,14.7-17.3,35.3-8,54
c9.3,14.7,23.7,23,41,23h3c32,1.3,54.7,25.3,56,56v225c1.3,64,48,110.3,112,113h35c12-1.3,21.7-9,23-21c12-86.7,79-147.7,167-149
c88,1.3,156,62.3,168,149C610.4,845.3,620.4,855,632.4,855z"/>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 457 B

0
imgs/bangumi_fav.svg → imgs/sub.svg
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 321 B

After

Width:  |  Height:  |  Size: 321 B

2
live/info.md
View File

@ -20,7 +20,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

32
live/manage.md
View File

@ -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端：<br />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：未改变<br />1：改变 |
| status | str | LIVE | |
| room_type | num | 0 | 作用尚不明确 |
| rtmp | obj | RTMP推流地址信息 | |
| protocols | srrary | ？？？ | 作用尚不明确 |
| try_time | str | ？？？ | 作用尚不明确 |
| live_key | str | ？？？ | 作用尚不明确 |
| notice | obj | ？？？ | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | ---------------- | ---------------------- |
| change | num | 是否改变状态 | 0：未改变<br />1：改变 |
| status | str | LIVE | |
| room_type | num | 0 | 作用尚不明确 |
| rtmp | obj | RTMP推流地址信息 | |
| protocols | array | ？？？ | 作用尚不明确 |
| try_time | str | ？？？ | 作用尚不明确 |
| live_key | str | ？？？ | 作用尚不明确 |
| notice | obj | ？？？ | 作用尚不明确 |
`data`中的`rtmp`对象：

45
login/login_action/QR.md
View File

@ -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字符 |
**示例：**

2
login/login_action/password.md
View File

@ -40,6 +40,8 @@ curl 'http://passport.bilibili.com/login?act=getkey'
*请求方式：POST*
鉴权方式：appkey
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |

45
login/member_center.md
View File

@ -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：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />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
}
```

34
other/API_auth.md
View File

@ -1,6 +1,6 @@
# API认证与鉴权
## Cookie方式
## Cookie方式（web端）
cookie中的值在访问登录接口成功登录时，用`set-cookie`写入
@ -15,30 +15,36 @@ Token有效期为1月，更改密码或过期失效
| SESSDATA | 登录Token | 用于用户识别与鉴权<br />作用同`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 | 安卓 | 取流专用 |
例如：

12
other/ip.md
View File

@ -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`对象：

12
other/time_stamp.md
View File

@ -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`对象：

12
other/zone_online.md
View File

@ -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`对象：

2
ranking&dynamic/dynamic.md
View File

@ -22,7 +22,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

2
ranking&dynamic/ranking.md
View File

@ -25,7 +25,7 @@
| ------- | ------ | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | array | 视频列表 | |
`data`数组：

2
search/search_request.md
View File

@ -30,7 +30,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

15
search/search_response.md
View File

@ -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
}
```

1
user/check_nickname.md
View File

@ -1,7 +1,6 @@
# 检查昵称是否可注册
也可用于判断指定昵称的用户是否存在
###
> http://passport.bilibili.com/web/generic/check/nickname
*请求方式:GET*

6
user/info.md
View File

@ -21,7 +21,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-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：成功<br />-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：成功<br />-101：未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

30
user/relation.md
View File

@ -26,7 +26,7 @@
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />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：成功<br />-400：请求错误<br />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：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />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：成功<br />-101：账号未登录<br />-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：成功<br />-101：账号未登录<br />-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：成功<br />-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：成功<br />-101：账号未登录<br />-400：请求错误<br />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：成功<br />-101：账号未登录<br />-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：成功<br />-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：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22106：该分组已经存在<br />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：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22103：分组名过长<br />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：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-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：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />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：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />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：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
**示例：**

3169
user/space.md
View File

File diff suppressed because it is too large Load Diff

36
user/status_number.md
View File

@ -19,7 +19,7 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-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：成功<br />-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：成功<br />-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
{

6
video/info.md
View File

@ -23,7 +23,7 @@
| ------- | ---- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-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：成功<br />-400：请求错误<br />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：成功<br />-400：请求错误<br />-404：无视频 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | array | 分P列表 | |
数组`data`：

571
video/like_coin_fav.md
View File

@ -2,17 +2,17 @@
**本页所有操作均需登录（Cookie或APP）**
## 操作
### 点赞视频（web端）
## 点赞
<img src="/imgs/like.svg" width="100" height="100"/>
### 点赞视频（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：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />65006：已赞过<br />65004：取消点赞失败 |
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />65004：取消点赞失败<br />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：点赞<br />1：取消赞 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-400：请求错误<br />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：成功<br />-400：请求错误<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | num | 被点赞标志 | 0：未点赞<br />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
}
```
## 投币
<img src="/imgs/coin.svg" width="100" height="100"/>
### 投币视频（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：不点赞<br />1：同时点赞<br />默认为0 |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 是否附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -91,9 +205,9 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like'\
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34005：超过投币上限 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34004：投币间隔太短<br />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端）
<img src="/imgs/fav.svg" width="100" height="100"/>
> 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：不点赞<br />1：同时点赞<br />默认为0 |
**json回复：**
@ -165,7 +276,136 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add'\
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403：访问权限不足<br />10003：不存在该稿件<br />11201：已经收藏过了<br />11202：已经取消收藏了<br />72010017：参数错误 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-400：请求错误<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34004：投币间隔太短<br />34005：超过投币上限 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ----------------------------------------------------- |
| like | bool | 是否点赞成功 | true：成功<br />false：失败<br />已赞过则附加点赞失败 |
为视频`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：成功<br />-400：请求错误<br />-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
}
}
```
## 收藏
<img src="/imgs/fav.svg" width="100" height="100"/>
### 收藏视频（双端）
> 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：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403：访问权限不足<br />10003：不存在该稿件<br />11201：已经收藏过了<br />11202：已经取消收藏了<br />11203：达到收藏上限<br />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：成功<br />-400：请求错误<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------------------------- |
| count | num | 1 | 作用尚不明确 |
| favoured | bool | 是否收藏 | true：已收藏<br />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
}
}
```
## 一键三连
<img src="/imgs/like.svg" align="left" width="50" height="50"/><img src="/imgs/coin.svg" align="left" width="50" height="50"/><img src="/imgs/fav.svg" width="50" height="50"/>
### 一键三连视频（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：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />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
<img src="/imgs/like.svg" width="100" height="100"/>
*请求方式：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：成功<br />-400：请求错误<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | num | 被点赞标志 | 0：未点赞<br />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
}
```
### 视频是否被投币
<img src="/imgs/coin.svg" width="100" height="100"/>
> 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：成功<br />-400：请求错误<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />10003：不存在该稿件 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | --------- |
| multiply | num | 投币枚数 | 未投币为0 |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------ | --------------------------- |
| like | bool | 是否点赞成功 | true：成功<br />false：失败 |
| coin | bool | 是否投币成功 | true：成功<br />false：失败 |
| fav | bool | 是否收藏成功 | true：成功<br />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
}
}
```
### 视频是否被收藏
<img src="/imgs/fav.svg" width="100" height="100"/>
> http://api.bilibili.com/x/v2/fav/video/favoured
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | -------- | ------------------ | ------ | ---- |
| aid | num或str | 视频avID或视频bvID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------------------------- |
| count | num | 1 | 作用尚不明确 |
| favoured | bool | 是否收藏 | true：已收藏<br />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'
```

5
video/pbp.md
View File

@ -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
{

16
video/recommend.md
View File

@ -23,7 +23,7 @@
| ------- | ------ | -------- | ---------------------------- |
| code | num | 返回值 | 0：成功 <br />-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
{

65
video/report.md
View File

@ -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 | 观看进度 | 非必要 | 单位为秒<br />默认为0 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | --------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 视频avID | 必要 | |
| cid | num | 视频CID | 必要 | 用于识别分P |
| progress | num | 观看进度 | 非必要 | 单位为秒<br />默认为0 |
| platform | str | 平台标识 | 非必要 | 可为android |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -25,13 +29,35 @@
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-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：成功<br />-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
{

113
video/snapshot.md
View File

@ -6,7 +6,7 @@
截取时间表的时间和快照一一对应，并按照从左到右 从上到下的顺序排布
## 获取视频快照1（用于进度条预览）
## 获取视频快照（web端）
> http://api.bilibili.com/x/player/videoshot
*请求方式：GET*
@ -28,7 +28,7 @@
| ------- | ---- | -------- | ------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />40001：请求错误<br />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：成功 <br />-3：API校验密匙错误<br />-400：请求错误<br />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：成功<br />40001：请求错误<br />-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
{

6
video/status_number.md
View File

@ -19,7 +19,7 @@
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功<br />40001：请求错误<br />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：成功 <br />-400：请求错误<br />-412：请求被拦截<br />40003：无视频 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：

54
video/tags.md
View File

@ -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：成功 <br />-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：成功 <br />-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：成功 <br />-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
{

4
video/video_zone.md
View File

@ -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) |

4
video/videostream_url.md
View File

@ -49,7 +49,7 @@
| ------- | ----------------------------- | -------- | ---------------------------------------------- |
| code | num | 返回值 | 0：成功 <br />-400：请求错误<br />-404：无视频 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | 有效时：obj<br />无效时：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**故无法获取