diff --git a/danmaku/snapshot.md b/danmaku/snapshot.md index 28180cf..d14dca6 100644 --- a/danmaku/snapshot.md +++ b/danmaku/snapshot.md @@ -12,9 +12,9 @@ http://api.bilibili.com/x/v2/dm/ajax 参数: -| 参数名 | 内容 | 必要性 | 备注 | -| ------ | -------- | ------ | ---- | -| aid | 视频avID | 必要 | | +| 参数名 | 内容 | 必要性 | 备注 | +| ------ | ------------------ | ------ | ---- | +| aid | 视频avID或视频bvID | 必要 | | **json回复:** @@ -38,6 +38,8 @@ http://api.bilibili.com/x/v2/dm/ajax http://api.bilibili.com/x/v2/dm/ajax?aid=43337021 +同http://api.bilibili.com/x/v2/dm/ajax?aid=BV1rb411m7gE + ```json { "code": 0, diff --git a/electric/Bcoin.md b/electric/Bcoin.md index a3eb98f..1ed458a 100644 --- a/electric/Bcoin.md +++ b/electric/Bcoin.md @@ -10,7 +10,7 @@ http://api.bilibili.com/x/ugcpay/trade/elec/pay/quick 需要登录(SESSDATA) -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | -------- | ------------------- | ------ | ------------------------------------------------- | diff --git a/electric/charge_msg.md b/electric/charge_msg.md index e3fc023..2787b72 100644 --- a/electric/charge_msg.md +++ b/electric/charge_msg.md @@ -6,7 +6,7 @@ http://api.bilibili.com/x/ugcpay/trade/elec/message 需要登录(SESSDATA) -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | -------- | ------------------- | ------ | ---- | diff --git a/login/QR.md b/login/QR.md index 37e3ea6..162075b 100644 --- a/login/QR.md +++ b/login/QR.md @@ -15,7 +15,7 @@ ## 申请二维码URL及扫码秘钥 -http://passport.bilibili.com/qrcode/getLoginUrl +> http://passport.bilibili.com/qrcode/getLoginUrl *方式:GET* @@ -58,7 +58,7 @@ http://passport.bilibili.com/qrcode/getLoginUrl ## 验证二维码登录 -http://passport.bilibili.com/qrcode/getLoginInfo +> http://passport.bilibili.com/qrcode/getLoginInfo *方式:POST* @@ -68,14 +68,14 @@ http://passport.bilibili.com/qrcode/getLoginInfo 「sid」「DedeUserID」 「DedeUserID__ckMd5」 「SESSDATA」 「bili_jct」 -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | ---------| ------------ | ------ |------------------------------ | | oauthKey | 扫码登录秘钥 | 必要 | | | gourl | 跳转url | 非必要 | 默认为http://www.bilibili.com | - **json回复:** + | 字段 | 类型 | 内容 | 备注 | | ------- | ------------------------ | ----------------------------------------- | ------------------------------------------------------------ | | status | bool | 扫码是否成功 | | @@ -93,7 +93,7 @@ data 对象: curl -d "oauthKey=xxx" "http://passport.bilibili.com/qrcode/getLoginInfo" -当秘钥正确时但未扫描时`status`为false,`data`为num值-4 +当秘钥正确时但未扫描时`status`为false,`data`为num值`-4` ```json { @@ -103,7 +103,7 @@ curl -d "oauthKey=xxx" "http://passport.bilibili.com/qrcode/getLoginInfo" } ``` -扫描成功但手机端未确认时`status`为false,`data`为num值-4 +扫描成功但手机端未确认时`status`为`false`,`data`为num值`-5` ```json { @@ -113,7 +113,7 @@ curl -d "oauthKey=xxx" "http://passport.bilibili.com/qrcode/getLoginInfo" } ``` -扫描成功手机端确认登录后,`status`为true,`data`为对象,并向浏览器写入cookie +扫描成功手机端确认登录后,`status`为`true`,`data`为对象,并向浏览器写入cookie ```json { diff --git a/login/login_info.md b/login/login_info.md index 97aaf4c..b219eaf 100644 --- a/login/login_info.md +++ b/login/login_info.md @@ -2,9 +2,9 @@ ## 登录用户信息1(完整) -http://api.bilibili.com/nav (使用转义) - -http://api.bilibili.com/x/web-interface/nav (原始数据) +> http://api.bilibili.com/nav (使用转义) +> +> http://api.bilibili.com/x/web-interface/nav (原始数据) *方式:GET* @@ -92,6 +92,8 @@ http://api.bilibili.com/x/web-interface/nav (原始数据) 示例: +查询当前登录用户的信息 + http://api.bilibili.com/x/web-interface/nav ```json @@ -154,7 +156,7 @@ http://api.bilibili.com/x/web-interface/nav ## 登录用户信息2(仅部分 带有转义) -http://account.bilibili.com/home/userInfo (带有转义) +> http://account.bilibili.com/home/userInfo (带有转义) *方式:GET* @@ -198,6 +200,8 @@ http://account.bilibili.com/home/userInfo (带有转义) 示例: +查询当前登录用户的信息 + http://account.bilibili.com/home/userInfo ```json @@ -230,7 +234,7 @@ http://account.bilibili.com/home/userInfo ## 登录用户状态数 -http://api.bilibili.com/x/web-interface/nav/stat +> http://api.bilibili.com/x/web-interface/nav/stat *方式:GET* @@ -253,6 +257,10 @@ http://api.bilibili.com/x/web-interface/nav/stat 示例: +查询当前登录用户的状态数 + +粉丝数为365,关注数为695,发送的动态数为162 + http://api.bilibili.com/x/web-interface/nav/stat ```json @@ -267,5 +275,3 @@ http://api.bilibili.com/x/web-interface/nav/stat } } ``` - -粉丝数为365,关注数为695,发送的动态数为162 \ No newline at end of file diff --git a/user/info.md b/user/info.md index 0d13314..71e9607 100644 --- a/user/info.md +++ b/user/info.md @@ -3,7 +3,7 @@ ## 用户详细信息1 (用于空间) -http://api.bilibili.com/x/space/acc/info +> http://api.bilibili.com/x/space/acc/info *方式:GET* @@ -119,7 +119,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png ## 用户详细信息2 (用于名片) -http://api.bilibili.com/x/web-interface/card +> http://api.bilibili.com/x/web-interface/card *方式:GET* @@ -322,7 +322,7 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true ## 本用户详细信息 -http://api.bilibili.com/x/space/myinfo +> http://api.bilibili.com/x/space/myinfo *方式:GET* diff --git a/user/relation.md b/user/relation.md index 995ac93..fbce5e3 100644 --- a/user/relation.md +++ b/user/relation.md @@ -4,7 +4,7 @@ -http://api.bilibili.com/x/relation/followers +> http://api.bilibili.com/x/relation/followers *方式:GET* @@ -86,6 +86,8 @@ http://api.bilibili.com/x/relation/followers 示例: +以每页2项的方式获取UID为293793435的用户的第1页的粉丝明细 + http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1 ```json @@ -151,15 +153,13 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1 } ``` -以每页2项的方式获取了UID为293793435的用户的第1页的粉丝明细 - ## 查询用户关注明细 -http://api.bilibili.com/x/relation/followings +> http://api.bilibili.com/x/relation/followings *方式:GET* @@ -249,6 +249,8 @@ data 对象: 示例: +以每页2项的方式获取UID为293793435的用户的第1页的关注明细 + http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1 ```json @@ -314,21 +316,19 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1 } ``` -以每页2项的方式获取了UID为293793435的用户的第1页的关注明细 - ## 操作用户关系(关注/取关 等) -http://api.bilibili.com/x/relation/modify +> http://api.bilibili.com/x/relation/modify *方式:POST* 需要登录(SESSDATA) -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | ------ | ------------------- | ------ | ---- | @@ -359,6 +359,8 @@ http://api.bilibili.com/x/relation/modify 示例: +关注了UID为14082的用户 + curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili.com/x/relation/modify ```json @@ -369,13 +371,11 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili } ``` -成功关注了UID为14082的用户 - ## 查询用户与自己关系1 (仅查关注) -http://api.bilibili.com/x/relation +> http://api.bilibili.com/x/relation *方式:GET* @@ -416,6 +416,8 @@ http://api.bilibili.com/x/relation 示例: +可得对于UID为258150656的用户,在2018/10/28 0:51:41时关注,且设为特别关注,并位于ID为-10分组中 + http://api.bilibili.com/x/relation?fid=258150656 ```json @@ -433,13 +435,11 @@ http://api.bilibili.com/x/relation?fid=258150656 } ``` -可得对于UID为258150656的用户,在2018/10/28 0:51:41时关注,且设为特别关注,并位于ID为-10分组中 - ## 查询用户与自己关系2(互相) -http://api.bilibili.com/x/space/acc/relation +> http://api.bilibili.com/x/space/acc/relation *方式:GET* @@ -497,6 +497,8 @@ http://api.bilibili.com/x/space/acc/relation 示例: +可得对于UID为15858903的用户,在2019/1/24 14:24:19时关注了对方,且互相关注,自己将对方特别关注,并同时位于ID为-10和194110的分组中,对方也将自己设为特别关注,并同时位于-10和56502的分组中(虽然我看不到) + http://api.bilibili.com/x/space/acc/relation?mid=15858903 ```json @@ -525,15 +527,13 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903 } ``` -可得对于UID为15858903的用户,在2019/1/24 14:24:19时关注了对方,且互相关注,自己将对方特别关注,并同时位于ID为-10和194110的分组中,对方也将自己设为特别关注,并同时位于-10和56502的分组中(虽然我看不到) - ## 关注分组相关 ### 查询关注分组列表 -http://api.bilibili.com/x/relation/tags +> http://api.bilibili.com/x/relation/tags *方式:GET* @@ -567,6 +567,8 @@ http://api.bilibili.com/x/relation/tags 示例: +查询所有的分组的名字以及ID + http://api.bilibili.com/x/relation/tags ```json @@ -592,13 +594,11 @@ http://api.bilibili.com/x/relation/tags } ``` -查询到了一些分组的名字以及ID - ### 查询关注分组明细 -http://api.bilibili.com/x/relation/tag +> http://api.bilibili.com/x/relation/tag *方式:GET* @@ -668,6 +668,8 @@ http://api.bilibili.com/x/relation/tag 示例: +以每页2项的方式获取了分组ID为207542分组的第1页的粉丝明细 + http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 ```json @@ -721,13 +723,11 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 } ``` -以每页2项的方式获取了分组ID为207542分组的第1页的粉丝明细 - ### 查询目标用户所在的分组 -http://api.bilibili.com/x/relation/tag/user +> http://api.bilibili.com/x/relation/tag/user *方式:GET* @@ -758,6 +758,8 @@ http://api.bilibili.com/x/relation/tag/user 示例: +查询用户319214221存在的分组的ID和名称 + http://api.bilibili.com/x/relation/tag/user?fid=319214221 ```json @@ -772,21 +774,19 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221 } ``` -查询到了UID为319214221的用户同时存在的两个分组的ID和名称 - ### 创建关注分组 -http://api.bilibili.com/x/relation/tag/create +> http://api.bilibili.com/x/relation/tag/create *方式:POST* 需要登录(SESSDATA) -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | ------ | ------------------- | ------ | ---------- | @@ -810,6 +810,8 @@ http://api.bilibili.com/x/relation/tag/create 示例: +创建了名为"vUP"的分组,ID为216677 + curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/tag/create ```json @@ -823,19 +825,17 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta } ``` -成功创建了名为"vUP"的分组,ID为216677 - ### 重命名关注分组 -http://api.bilibili.com/x/relation/tag/update +> http://api.bilibili.com/x/relation/tag/update *方式:POST* 需要登录(SESSDATA) -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | ------ | ------------------- | ------ | ---------- | @@ -853,6 +853,8 @@ http://api.bilibili.com/x/relation/tag/update 示例: +把ID为194112的分组更名为"膜法师" + curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" http://api.bilibili.com/x/relation/tag/update ```json @@ -863,21 +865,19 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" } ``` -成功把ID为194112的分组更名为"膜法师" - ### 删除关注分组 -http://api.bilibili.com/x/relation/tag/del +> http://api.bilibili.com/x/relation/tag/del *方式:POST* 需要登录(SESSDATA) -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | ------ | ------------------- | ------ | ---- | @@ -894,6 +894,8 @@ http://api.bilibili.com/x/relation/tag/del 示例: +删除分组ID为216699的分组 + curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relation/tag/del ```json @@ -904,21 +906,19 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati } ``` -成功删除了分组ID为216699的分组 - ### 修改用户分组关系(添加/删除) -http://api.bilibili.com/x/relation/tags/addUsers +> http://api.bilibili.com/x/relation/tags/addUsers *方式:POST* 需要登录(SESSDATA) -参数: +参数( application/x-www-form-urlencoded ): | 参数名 | 内容 | 必要性 | 备注 | | ------ | ------------------- | ------ | ------------------------ | @@ -936,6 +936,8 @@ http://api.bilibili.com/x/relation/tags/addUsers 示例: +把UID为205631797的用户同时添加到了分组ID为-10和207542的分组中 + curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api.bilibili.com/x/relation/tags/addUsers ```json @@ -946,4 +948,3 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api } ``` -成功把UID为205631797的用户同时添加到了分组ID为-10和207542的分组中 \ No newline at end of file diff --git a/user/status_number.md b/user/status_number.md index 19b20fb..ea7e1bb 100644 --- a/user/status_number.md +++ b/user/status_number.md @@ -1,7 +1,7 @@ # 用户状态数 ## 关系状态数 -http://api.bilibili.com/x/relation/stat +> http://api.bilibili.com/x/relation/stat *方式:GET* @@ -30,7 +30,10 @@ http://api.bilibili.com/x/relation/stat 示例: +查询用户332704117的关系状态数 + http://api.bilibili.com/x/relation/stat?vmid=332704117 + ```json { "code": 0, @@ -47,7 +50,7 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117 ``` ## UP主状态数 -http://api.bilibili.com/x/space/upstat +> http://api.bilibili.com/x/space/upstat *方式:GET* @@ -87,6 +90,8 @@ http://api.bilibili.com/x/space/upstat 示例: +查询用户456664753的up主状态数 + http://api.bilibili.com/x/space/upstat?mid=456664753 ```json { @@ -106,7 +111,7 @@ http://api.bilibili.com/x/space/upstat?mid=456664753 ``` ## 订阅&投稿状态数 -http://api.bilibili.com/x/space/navnum +> http://api.bilibili.com/x/space/navnum *方式:GET* @@ -154,10 +159,11 @@ http://api.bilibili.com/x/space/navnum | master | num | 全部收藏夹数 | 需要登录(SESSDATA) 只能查看自己的 | | guest | num | 公开收藏夹数 | 无视隐私设置 | - 示例: -http://api.bilibili.com/x/space/navnum?mid=23920239 +查询用户239202390的订阅&投稿状态数 + +http://api.bilibili.com/x/space/navnum?mid=239202390 ```json { "code": 0, diff --git a/video/info.md b/video/info.md index 1751a06..cd9ccc0 100644 --- a/video/info.md +++ b/video/info.md @@ -2,17 +2,18 @@ -## 视频详细信息 +## 视频详细信息(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, diff --git a/video/like_coin_fav.md b/video/like_coin_fav.md index 103da32..afdd812 100644 --- a/video/like_coin_fav.md +++ b/video/like_coin_fav.md @@ -8,15 +8,16 @@ -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点赞
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点赞 - ### 投币视频 -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不点赞
1同时点赞
默认为0 | | multiply | 投币数量 | 必要 | 上限为2 | | csrf | cookies中的bili_jct | 必要 | | @@ -65,7 +69,7 @@ http://api.bilibili.com/x/web-interface/coin/add | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0成功
-400请求错误
10003不存在该稿件
-111csrf校验失败
-101账号未登录
34005超过投币上限
34002不能给自己投币
-104硬币不足 | +| code | num | 返回值 | 0成功
-400请求错误
10003不存在该稿件
-111csrf校验失败
-101账号未登录
34002不能给自己投币
34003非法的投币数量
34005超过投币上限
-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) -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的收藏夹中 - ### 一键三连视频 -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 -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的状态为已收藏 - ### 视频是否被点赞 -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的状态为已点赞 - ### 视频是否被投币 -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枚 + diff --git a/video/recommend.md b/video/recommend.md index 63d9b5e..d6320ff 100644 --- 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, diff --git a/video/snapshot.md b/video/snapshot.md index 3cb952f..de28911 100644 --- 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需要
0不需要
默认为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* diff --git a/video/status_number.md b/video/status_number.md index bc0936e..ef42e0a 100644 --- 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
屏蔽时str | 普通:观看次数
屏蔽时:"--" | | | 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,