优化文档格式
This commit is contained in:
SocialSisterYi
@@ -1,16 +1,18 @@
|
||||
# 视频点赞&投币&收藏
|
||||
|
||||
**本页所有操作均需登录（SESSDATA）**
|
||||
**本页所有操作均需登录（Cookie或APP）**
|
||||
|
||||
## 操作
|
||||
|
||||
### 点赞视频
|
||||
### 点赞视频（web端）
|
||||
|
||||
<img src="/imgs/like.svg" width="100" height="100"/>
|
||||
|
||||
> http://api.bilibili.com/x/web-interface/archive/like
|
||||
|
||||
*方式：POST*
|
||||
*请求方式：POST*
|
||||
|
||||
认证&鉴权方式：仅可Cookie
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
@@ -33,11 +35,27 @@
|
||||
|
||||
**示例：**
|
||||
|
||||
为视频av79677524/BV1uJ411r7hL点赞
|
||||
为视频`av79677524`/`BV1uJ411r7hL`点赞
|
||||
|
||||
curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like"
|
||||
avID方式：
|
||||
|
||||
同curl -b "SESSDATA=xxx" -d "aid=BV1uJ411r7hL&like=1&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like"
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/archive/like'\
|
||||
--data-urlencode 'aid=79677524'\
|
||||
--data-urlencode 'like=1'\
|
||||
--data-urlencode 'csrf=xxx'\
|
||||
-b 'SESSDATA=xxx'
|
||||
```
|
||||
|
||||
bvID方式：
|
||||
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/archive/like'\
|
||||
--data-urlencode 'bvid=BV1uJ411r7hL'\
|
||||
--data-urlencode 'like=1'\
|
||||
--data-urlencode 'csrf=xxx'\
|
||||
-b 'SESSDATA=xxx'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -47,15 +65,15 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 投币视频
|
||||
### 投币视频（web端）
|
||||
|
||||
<img src="/imgs/coin.svg" width="100" height="100"/>
|
||||
|
||||
> http://api.bilibili.com/x/web-interface/coin/add
|
||||
|
||||
*方式：POST*
|
||||
*请求方式：POST*
|
||||
|
||||
认证&鉴权方式：仅可Cookie
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
@@ -86,11 +104,29 @@ data 对象：
|
||||
|
||||
**示例：**
|
||||
|
||||
|
||||
|
||||
为视频`av90671873`/`BV1N7411A7wC`投币2枚
|
||||
|
||||
curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http://api.bilibili.com/x/web-interface/coin/add"
|
||||
avID方式：
|
||||
|
||||
同curl -b "SESSDATA=xxx" -d "bvid=BV1N7411A7wC&select_like=1&multiply=2&csrf=xxx" "http://api.bilibili.com/x/web-interface/coin/add"
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/coin/add'\
|
||||
--data-urlencode 'aid=90671873'\
|
||||
--data-urlencode 'select_like=1'\
|
||||
--data-urlencode 'multiply=2'\
|
||||
--data-urlencode 'csrf=xxx'\
|
||||
-b 'SESSDATA=xxx'
|
||||
```
|
||||
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/coin/add'\
|
||||
--data-urlencode 'bvid=BV1N7411A7wC'\
|
||||
--data-urlencode 'select_like=1'\
|
||||
--data-urlencode 'multiply=2'\
|
||||
--data-urlencode 'csrf=xxx'\
|
||||
-b 'SESSDATA=xxx'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -103,27 +139,25 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 收藏视频（暂不支持bvID）
|
||||
|
||||
<img src="/imgs/fav.svg" width="100" height="100"/>
|
||||
|
||||
> http://api.bilibili.com/medialist/gateway/coll/resource/deal
|
||||
|
||||
*方式：POST*
|
||||
*请求方式：POST*
|
||||
|
||||
需要验证`referer`为 `http://www.bilibili.com`或`https://www.bilibili.com`域名下
|
||||
需要验证`referer`为 `.bilibili.com`域名下
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ------------- | ---- | ------------------------ | ------ | ----------------------- |
|
||||
| rid | num | 视频avID | 必要 | |
|
||||
| type | num | 必须为2 | 必要 | |
|
||||
| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个，用`,`分隔 |
|
||||
| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个，用`,`分隔 |
|
||||
| csrf | str | CSRF Token（位于cookie） | 必要 | |
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ------------- | ---- | ------------------------ | ------ | ------------------------------ |
|
||||
| rid | num | 视频avID | 必要 | |
|
||||
| type | num | 必须为2 | 必要 | |
|
||||
| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
|
||||
| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
|
||||
| csrf | str | CSRF Token（位于cookie） | 必要 | |
|
||||
|
||||
**json回复：**
|
||||
|
||||
@@ -145,7 +179,16 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
|
||||
|
||||
将视频`av49166435`添加到收藏夹`49166435`中
|
||||
|
||||
curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type=2&add_media_ids=49166435&del_media_ids=&csrf=xxx" "http://api.bilibili.com/medialist/gateway/coll/resource/deal"
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\
|
||||
--data-urlencode 'rid=90671873'\
|
||||
--data-urlencode 'type=2'\
|
||||
--data-urlencode 'add_media_ids=49166435'\
|
||||
--data-urlencode 'del_media_ids='\
|
||||
--data-urlencode 'csrf=xxx'\
|
||||
-b 'SESSDATA=xxx'
|
||||
-e 'https://www.bilibili.com'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -157,15 +200,13 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 一键三连视频
|
||||
### 一键三连视频（web端）
|
||||
|
||||
<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"/>
|
||||
|
||||
> http://api.bilibili.com/x/web-interface/archive/like/triple
|
||||
|
||||
*方式：POST*
|
||||
*请求方式：POST*
|
||||
|
||||
同时点赞投币收藏视频，收藏于默认收藏夹中
|
||||
|
||||
@@ -190,20 +231,34 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
|
||||
|
||||
`data`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| -------- | ---- | ------------ | ------- |
|
||||
| like | bool | 是否点赞成功 | |
|
||||
| coin | bool | 是否投币成功 | |
|
||||
| fav | bool | 是否收藏成功 | |
|
||||
| multiply | num | 投币枚数 | 默认为2 |
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| -------- | ---- | ------------ | --------------------------- |
|
||||
| like | bool | 是否点赞成功 | true：成功<br />false：失败 |
|
||||
| coin | bool | 是否投币成功 | true：成功<br />false：失败 |
|
||||
| fav | bool | 是否收藏成功 | true：成功<br />false：失败 |
|
||||
| multiply | num | 投币枚数 | 默认为2 |
|
||||
|
||||
**示例：**
|
||||
|
||||
将视频`av91003840`/`BV1Wj411f79U`一键三连
|
||||
|
||||
curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like/triple"
|
||||
avID方式：
|
||||
|
||||
同curl -b "SESSDATA=xxx" -d "bvid=BV1Wj411f79U&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like/triple"
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/archive/like/triple'\
|
||||
--data-urlencode 'aid=91003840'\
|
||||
--data-urlencode 'csrf=xxx'\
|
||||
-b 'SESSDATA=xxx'
|
||||
```
|
||||
|
||||
bvID方式：
|
||||
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/archive/like/triple'\
|
||||
--data-urlencode 'bvid=BV1Wj411f79U'\
|
||||
--data-urlencode 'csrf=xxx'\
|
||||
-b 'SESSDATA=xxx'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -219,71 +274,15 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 判断状态
|
||||
|
||||
### 视频是否被收藏
|
||||
|
||||
<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`的状态为已收藏
|
||||
|
||||
http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
|
||||
|
||||
同http://api.bilibili.com/x/v2/fav/video/favoured?aid=BV1Bb411H7Dv
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"message": "0",
|
||||
"ttl": 1,
|
||||
"data": {
|
||||
"count": 1,
|
||||
"favoured": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 视频是否被点赞
|
||||
|
||||
<img src="/imgs/like.svg" width="100" height="100"/>
|
||||
|
||||
> http://api.bilibili.com/x/web-interface/archive/has/like
|
||||
|
||||
*方式:GET*
|
||||
*请求方式：GET*
|
||||
|
||||
**url参数：**
|
||||
|
||||
@@ -307,9 +306,21 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
|
||||
|
||||
视频`av39330059`/`BV1Bt411z799`的状态为已点赞
|
||||
|
||||
http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
|
||||
avID方式：
|
||||
|
||||
同http://api.bilibili.com/x/web-interface/archive/has/like?bvid=BV1Bt411z799
|
||||
```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
|
||||
{
|
||||
@@ -320,15 +331,13 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 视频是否被投币
|
||||
|
||||
<img src="/imgs/coin.svg" width="100" height="100"/>
|
||||
|
||||
> http://api.bilibili.com/x/web-interface/archive/coins
|
||||
|
||||
*方式:GET*
|
||||
*请求方式：GET*
|
||||
|
||||
**url参数：**
|
||||
|
||||
@@ -358,9 +367,21 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
|
||||
|
||||
视频`av37896701`/`BV18t411q7zz`的投币数为2枚
|
||||
|
||||
http://api.bilibili.com/x/web-interface/archive/coins?aid=37896701
|
||||
avID方式：
|
||||
|
||||
同http://api.bilibili.com/x/web-interface/archive/coins?bvid=BV18t411q7zz
|
||||
```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
|
||||
{
|
||||
@@ -373,5 +394,67 @@ http://api.bilibili.com/x/web-interface/archive/coins?aid=37896701
|
||||
}
|
||||
```
|
||||
|
||||
### 视频是否被收藏
|
||||
|
||||
<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
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user