添加bvID相关和POST参数类型

2020-03-23 16:46:13 +08:00
parent 30a6f2c275
commit 8521edff89
13 changed files with 213 additions and 161 deletions
--- a/video/info.md
+++ b/video/info.md
@@ -2,17 +2,18 @@

 <img src="/imgs/ploading.gif" width="100" height="100"/>

-## 视频详细信息
+## 视频详细信息（avID/bvID互转）

-http://api.bilibili.com/x/web-interface/view
+> http://api.bilibili.com/x/web-interface/view

 *方式:GET*

 参数：

-| 参数名 | 内容     | 必要性 | 备注 |
-| ------ | -------- | ------ | ---- |
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容     | 必要性 | 备注               |
+| ------ | -------- | ------ | ------------------ |
+| aid    | 视频avID | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID | 非必要 | avID与bvID任选一个 |

 **json回复：**

@@ -27,7 +28,7 @@ http://api.bilibili.com/x/web-interface/view

 | 字段         | 类型  | 内容                           | 备注                  |
 | ------------ | ----- | ------------------------------ | --------------------- |
-| bvid         | str   | 空                             | 作用尚不明确          |
+| bvid         | str   | 视频bvID                       |                       |
 | aid          | num   | 视频avID                       |                       |
 | videos       | num   | 视频分P总数                    | 默认为1               |
 | tid          | num   | 分区ID                         |                       |
@@ -207,13 +208,15 @@ http://api.bilibili.com/x/web-interface/view

 http://api.bilibili.com/x/web-interface/view?aid=85440373

+同http://api.bilibili.com/x/web-interface/view?bvid=BV117411r7R1
+
 ```json
 {
 	"code": 0,
 	"message": "0",
 	"ttl": 1,
 	"data": {
-		"bvid": "",
+		"bvid": "BV117411r7R1",
 		"aid": 85440373,
 		"videos": 1,
 		"tid": 28,
@@ -245,19 +248,19 @@ http://api.bilibili.com/x/web-interface/view?aid=85440373
 		"owner": {
 			"mid": 66606350,
 			"name": "Crazy_Bucket",
-			"face": "http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg"
+			"face": "http://i2.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg"
 		},
 		"stat": {
 			"aid": 85440373,
-			"view": 1362470,
-			"danmaku": 8753,
-			"reply": 2489,
-			"favorite": 47970,
-			"coin": 55627,
-			"share": 7927,
+			"view": 1419319,
+			"danmaku": 9203,
+			"reply": 2519,
+			"favorite": 49031,
+			"coin": 57470,
+			"share": 8120,
 			"now_rank": 0,
 			"his_rank": 55,
-			"like": 115395,
+			"like": 118462,
 			"dislike": 0,
 			"evaluation": ""
 		},
@@ -291,7 +294,7 @@ http://api.bilibili.com/x/web-interface/view?aid=85440373
 			"mid": 66606350,
 			"title": "UP主",
 			"name": "Crazy_Bucket",
-			"face": "http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg",
+			"face": "http://i2.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg",
 			"vip": {
 				"type": 2,
 				"status": 1,
@@ -304,7 +307,7 @@ http://api.bilibili.com/x/web-interface/view?aid=85440373
 				"desc": "",
 				"type": 0
 			},
-			"follower": 333883,
+			"follower": 369687,
 			"label_style": 0
 		}, {
 			"mid": 53456,
@@ -323,7 +326,7 @@ http://api.bilibili.com/x/web-interface/view?aid=85440373
 				"desc": "",
 				"type": 0
 			},
-			"follower": 1398071,
+			"follower": 1452718,
 			"label_style": 0
 		}]
 	}
@@ -346,15 +349,16 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg

 ## 视频简介

-http://api.bilibili.com/x/web-interface/archive/desc
+> http://api.bilibili.com/x/web-interface/archive/desc

 *方式:GET*

 参数：

-| 参数名 | 内容     | 必要性 | 备注 |
-| ------ | -------- | ------ | ---- |
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容     | 必要性 | 备注               |
+| ------ | -------- | ------ | ------------------ |
+| aid    | 视频avID | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID | 非必要 | avID与bvID任选一个 |

 **json回复：**

@@ -369,6 +373,8 @@ http://api.bilibili.com/x/web-interface/archive/desc

 http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059

+同http://api.bilibili.com/x/web-interface/archive/desc?bvid=BV1Bt411z799
+
 ~~（教主的咕鸽）~~

 ```json
@@ -380,17 +386,18 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
 }
 ```

-## 视频分P列表  (avID转CID)
+## 视频分P列表  (avID/bvID转CID)

-http://api.bilibili.com/x/player/pagelist
+> http://api.bilibili.com/x/player/pagelist

 *方式:GET*

 参数：

-| 参数名 | 内容     | 必要性 | 备注 |
-| ------ | -------- | ------ | ---- |
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容     | 必要性 | 备注               |
+| ------ | -------- | ------ | ------------------ |
+| aid    | 视频avID | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID | 非必要 | avID与bvID任选一个 |

 **json回复：**

@@ -434,6 +441,8 @@ http://api.bilibili.com/x/player/pagelist

 http://api.bilibili.com/x/player/pagelist?aid=13502509

+同http://api.bilibili.com/x/player/pagelist?bvid=BV1ex411J7GE
+
 ```json
 {
 	"code": 0,
--- a/video/like_coin_fav.md
+++ b/video/like_coin_fav.md
@@ -8,15 +8,16 @@

 <img src="/imgs/like.svg" width="100" height="100"/>

-http://api.bilibili.com/x/web-interface/archive/like
+> http://api.bilibili.com/x/web-interface/archive/like

 *方式：POST*

-参数：
+参数（ application/x-www-form-urlencoded ）：

 | 参数名 | 内容                | 必要性 | 备注               |
 | ------ | ------------------- | ------ | ------------------ |
-| aid    | 视频avID            | 必要   |                    |
+| aid    | 视频avID            | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID            | 非必要 | avID与bvID任选一个 |
 | like   | 操作方式            | 必要   | 1点赞<br />2取消赞 |
 | csrf   | cookies中的bili_jct | 必要   |                    |

@@ -30,8 +31,12 @@ http://api.bilibili.com/x/web-interface/archive/like

 示例：

+为视频av79677524/BV1uJ411r7hL点赞
+
 curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like"

+同curl -b "SESSDATA=xxx" -d "aid=BV1uJ411r7hL&like=1&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like"
+
 ```json
 {
 	"code": 0,
@@ -40,23 +45,22 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
 }
 ```

-成功为视频av79677524点赞
-


 ### 投币视频

 <img src="/imgs/coin.svg" width="100" height="100"/>

-http://api.bilibili.com/x/web-interface/coin/add
+> http://api.bilibili.com/x/web-interface/coin/add

 *方式：POST*

-参数：
+参数（ application/x-www-form-urlencoded ）：

 | 参数名      | 内容                | 必要性 | 备注                                |
 | ----------- | ------------------- | ------ | ----------------------------------- |
-| aid         | 视频avID            | 必要   |                                     |
+| aid         | 视频avID            | 非必要 | avID与bvID任选一个                  |
+| bvid        | 视频bvID            | 非必要 | avID与bvID任选一个                  |
 | select_like | 同时点赞            | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
 | multiply    | 投币数量            | 必要   | 上限为2                             |
 | csrf        | cookies中的bili_jct | 必要   |                                     |
@@ -65,7 +69,7 @@ http://api.bilibili.com/x/web-interface/coin/add

 | 字段    | 类型 | 内容     | 备注                                                         |
 | ------- | ---- | -------- | ------------------------------------------------------------ |
-| code    | num  | 返回值   | 0成功<br />-400请求错误<br />10003不存在该稿件<br />-111csrf校验失败<br />-101账号未登录<br />34005超过投币上限<br />34002不能给自己投币<br />-104硬币不足 |
+| code    | num  | 返回值   | 0成功<br />-400请求错误<br />10003不存在该稿件<br />-111csrf校验失败<br />-101账号未登录<br />34002不能给自己投币<br />34003非法的投币数量<br />34005超过投币上限<br />-104硬币不足 |
 | message | str  | 错误信息 | 默认为0                                                      |
 | ttl     | num  | 1        | 作用尚不明确                                                 |
 | data    | obj  | 信息本体 |                                                              |
@@ -78,8 +82,12 @@ 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"

+同curl -b "SESSDATA=xxx" -d "bvid=BV1N7411A7wC&select_like=1&multiply=2&csrf=xxx" "http://api.bilibili.com/x/web-interface/coin/add"
+
 ```json
 {
 	"code": 0,
@@ -91,21 +99,19 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
 }
 ```

-成功为视频av90671873投币2枚


-
-### 收藏视频
+### 收藏视频（暂不支持bvID）

 <img src="/imgs/fav.svg" width="100" height="100"/>

-http://api.bilibili.com/medialist/gateway/coll/resource/deal
+> http://api.bilibili.com/medialist/gateway/coll/resource/deal

 *方式：POST*

 需要验证referer为 `http://www.bilibili.com`或`https://www.bilibili.com`域名下

-参数：
+参数（ application/x-www-form-urlencoded ）：

 | 参数名        | 内容                | 必要性 | 备注                    |
 | ------------- | ------------------- | ------ | ----------------------- |
@@ -131,6 +137,8 @@ http://api.bilibili.com/medialist/gateway/coll/resource/deal

 示例：

+将视频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"

 ```json
@@ -143,26 +151,25 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
 }
 ```

-成功将av49166435收藏到收藏夹ID为49166435的收藏夹中
-


 ### 一键三连视频

 <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
+> http://api.bilibili.com/x/web-interface/archive/like/triple

 *方式：POST*

 同时点赞投币收藏视频，收藏于默认收藏夹中

-参数：
+参数（ application/x-www-form-urlencoded ）：

-| 参数名 | 内容                | 必要性 | 备注 |
-| ------ | ------------------- | ------ | ---- |
-| aid    | 视频avID            | 必要   |      |
-| csrf   | cookies中的bili_jct | 必要   |      |
+| 参数名 | 内容                | 必要性 | 备注               |
+| ------ | ------------------- | ------ | ------------------ |
+| aid    | 视频avID            | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID            | 非必要 | avID与bvID任选一个 |
+| csrf   | cookies中的bili_jct | 必要   |                    |

 **json回复：**

@@ -184,8 +191,12 @@ http://api.bilibili.com/x/web-interface/archive/like/triple

 示例：

+将视频av91003840/BV1Wj411f79U一键三连
+
 curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like/triple"

+同curl -b "SESSDATA=xxx" -d "bvid=BV1Wj411f79U&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like/triple"
+
 ```json
 {
 	"code": 0,
@@ -200,8 +211,6 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web
 }
 ```

-成功将视频av91003840一键三连
-


 ## 判断状态
@@ -210,15 +219,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
+> http://api.bilibili.com/x/v2/fav/video/favoured

 *方式:GET*

 参数：

-| 参数名 | 内容     | 必要性 | 备注 |
-| ------ | -------- | ------ | ---- |
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容               | 必要性 | 备注 |
+| ------ | ------------------ | ------ | ---- |
+| aid    | 视频avID或视频bvID | 必要   |      |

 **json回复：**

@@ -238,8 +247,12 @@ data 对象：

 示例：

+视频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,
@@ -252,23 +265,22 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
 }
 ```

-视频av46281123的状态为已收藏
-


 ### 视频是否被点赞

 <img src="/imgs/like.svg" width="100" height="100"/>

-http://api.bilibili.com/x/web-interface/archive/has/like
+> http://api.bilibili.com/x/web-interface/archive/has/like

 *方式:GET*

 参数：

-| 参数名 | 内容     | 必要性 | 备注 |
-| ------ | -------- | ------ | ---- |
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容     | 必要性 | 备注               |
+| ------ | -------- | ------ | ------------------ |
+| aid    | 视频avID | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID | 非必要 | avID与bvID任选一个 |

 **json回复：**

@@ -281,8 +293,12 @@ http://api.bilibili.com/x/web-interface/archive/has/like

 示例：

+视频av39330059/BV1Bt411z799的状态为已点赞
+
 http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059

+同http://api.bilibili.com/x/web-interface/archive/has/like?bvid=BV1Bt411z799
+
 ```json
 {
 	"code": 0,
@@ -292,23 +308,22 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
 }
 ```

-视频av39330059的状态为已点赞
-


 ### 视频是否被投币

 <img src="/imgs/coin.svg" width="100" height="100"/>

-http://api.bilibili.com/x/web-interface/archive/coins
+> http://api.bilibili.com/x/web-interface/archive/coins

 *方式:GET*

 参数：

-| 参数名 | 内容     | 必要性 | 备注 |
-| ------ | -------- | ------ | ---- |
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容     | 必要性 | 备注               |
+| ------ | -------- | ------ | ------------------ |
+| aid    | 视频avID | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID | 非必要 | avID与bvID任选一个 |

 **json回复：**

@@ -327,8 +342,12 @@ http://api.bilibili.com/x/web-interface/archive/coins

 示例：

+视频av37896701/BV18t411q7zz的投币数为2枚
+
 http://api.bilibili.com/x/web-interface/archive/coins?aid=37896701

+同http://api.bilibili.com/x/web-interface/archive/coins?bvid=BV18t411q7zz
+
 ```json
 {
 	"code": 0,
@@ -340,5 +359,5 @@ http://api.bilibili.com/x/web-interface/archive/coins?aid=37896701
 }
 ```

-视频av37896701的投币数为2枚
+

--- a/video/recommend.md
+++ b/video/recommend.md
@@ -2,7 +2,7 @@

 ## 获取单视频推荐列表

-http://api.bilibili.com/x/web-interface/archive/related
+> http://api.bilibili.com/x/web-interface/archive/related

 *方式:GET* 

@@ -10,9 +10,10 @@ http://api.bilibili.com/x/web-interface/archive/related

 参数：

-| 参数名 | 内容     | 必要性 | 备注 |
-| ------ | -------- | ------ | ---- |
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容     | 必要性 | 备注               |
+| ------ | -------- | ------ | ------------------ |
+| aid    | 视频avID | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID | 非必要 | avID与bvID任选一个 |

 **json回复：**

@@ -40,6 +41,8 @@ http://api.bilibili.com/x/web-interface/archive/related

 http://api.bilibili.com/x/web-interface/archive/related?aid=7

+同http://api.bilibili.com/x/web-interface/archive/related?bvid=BV1xx411c7m9
+
 ```json
 {
 	"code": 0,
--- a/video/snapshot.md
+++ b/video/snapshot.md
@@ -7,14 +7,15 @@
 截取时间表的时间和快照一一对应，并按照从左到右 从上到下的顺序排布

 ## 获取视频快照1（用于进度条预览）
-http://api.bilibili.com/x/player/videoshot
+> http://api.bilibili.com/x/player/videoshot

 *方式:GET* 

 参数：
 | 参数名 | 内容               | 必要性 | 备注                            |
 | ------ | ------------------ | ------ | ------------------------------- |
-| aid    | 视频avID           | 必要   |                                 |
+| aid    | 视频avID           | 非必要 | avID与bvID任选一个              |
+| bvid   | 视频bvID           | 非必要 | avID与bvID任选一个              |
 | cid    | 分P CID            | 非必要 | 默认为1P                        |
 | index  | json数组截取时间表 | 非必要 | 1需要<br />0不需要<br />默认为0 |

@@ -60,6 +61,8 @@ http://api.bilibili.com/x/player/videoshot

 http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1

+同http://api.bilibili.com/x/player/videoshot?bvid=BV1os411H7wm&index=1
+
 ```json
 {
 	"code": 0,
@@ -79,11 +82,9 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1



+## 获取视频快照2 （用于封面预览  暂不支持bvID）

-
-## 获取视频快照2 （用于封面预览）
-
-http://api.bilibili.com/pvideo
+> http://api.bilibili.com/pvideo

 *方式:GET*

--- a/video/status_number.md
+++ b/video/status_number.md
@@ -1,7 +1,7 @@
 # 视频状态数

-## 视频状态数1（备用  不封python）
-http://api.bilibili.com/archive_stat/stat
+## 视频状态数1（备用  不封python 暂不支持bvID）
+> http://api.bilibili.com/archive_stat/stat

 *方式:GET*

@@ -40,6 +40,7 @@ http://api.bilibili.com/archive_stat/stat
 示例：

 http://api.bilibili.com/archive_stat/stat?aid=91572143
+
 ```json
 {
 	"code": 0,
@@ -63,8 +64,8 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
 }
 ```

-## 视频状态数2（常用 封杀python）
-http://api.bilibili.com/x/web-interface/archive/stat
+## 视频状态数2（常用 封杀python）（avID/bvID互转）
+> http://api.bilibili.com/x/web-interface/archive/stat

 *方式:GET*

@@ -75,9 +76,10 @@ http://api.bilibili.com/x/web-interface/archive/stat
 **此API克python，UA中只要存在\*python\*字眼就无法获取正确内容，如用py请改UA**

 参数：
-| 参数名 | 内容     | 必要性 | 备注 |
-| -------| -------- | ------ |------|
-| aid    | 视频avID | 必要   |      |
+| 参数名 | 内容     | 必要性 | 备注               |
+| ------ | -------- | ------ | ------------------ |
+| aid    | 视频avID | 非必要 | avID与bvID任选一个 |
+| bvid   | 视频bvID | 非必要 | avID与bvID任选一个 |

 **json回复：**

@@ -93,7 +95,7 @@ http://api.bilibili.com/x/web-interface/archive/stat
 | 字段       | 类型                   | 内容                             | 备注             |
 | ---------- | ---------------------- | -------------------------------- | ---------------- |
 | aid        | num                    | 视频avID                         |                  |
-| bvid       | str                    | 空                               | 作用尚不明确     |
+| bvid       | str                    | 视频bvID                         |                  |
 | view       | 普通num<br />屏蔽时str | 普通：观看次数<br />屏蔽时："--" |                  |
 | danmaku    | num                    | 弹幕条数                         |                  |
 | reply      | num                    | 评论条数                         |                  |
@@ -112,6 +114,9 @@ http://api.bilibili.com/x/web-interface/archive/stat
 示例：

 http://api.bilibili.com/x/web-interface/archive/stat?aid=2271112
+
+同http://api.bilibili.com/x/web-interface/archive/stat?bvid=BV1es411D7sW
+
 ```json
 {
 	"code": 0,
@@ -119,14 +124,14 @@ http://api.bilibili.com/x/web-interface/archive/stat?aid=2271112
 	"ttl": 1,
 	"data": {
 		"aid": 2271112,
-		"bvid": "",
-		"view": 25719725,
-		"danmaku": 159249,
-		"reply": 52007,
-		"favorite": 879004,
-		"coin": 586071,
-		"share": 235709,
-		"like": 594645,
+		"bvid": "BV1es411D7sW",
+		"view": 26408224,
+		"danmaku": 161919,
+		"reply": 52825,
+		"favorite": 892560,
+		"coin": 599649,
+		"share": 240573,
+		"like": 628592,
 		"now_rank": 0,
 		"his_rank": 4,
 		"no_reprint": 0,