Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions 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
Download Patch File Download Diff File Expand all files Collapse all files

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