diff --git a/README.md b/README.md index 447e60b..741cef6 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,4 @@ -

- -

+

哔哩哔哩-API收集整理

@@ -17,6 +15,7 @@

+

野生API文档

不断更新中....

本项目旨在对B站web端、移动端以及TV端散落在世界各地的野生api进行收集整理,研究使用方法并对其进行说明,运用了黑箱法、控制变量法、js逆向分析法、网络抓包法等研究办法 @@ -35,7 +34,7 @@ PS:所有http协议地址均可使用https,文档中为了统一写作`http` - [图片格式化](other/picture.md)√ - [登录](login) - [登录操作(人机认证)](login/login_action)√ - + [短信登录](llogin/login_action/SMS.md)√ + + [短信登录](login/login_action/SMS.md)√ + [密码登录](login/login_action/password.md)√ + [二维码登录](login/login_action/QR.md)√ + SNS登录(QQ&微博) @@ -97,11 +96,12 @@ PS:所有http协议地址均可使用https,文档中为了统一写作`http` - [搜索请求](search/search_request.md)√ - [搜索结果](search/search_response.md)√ - [默认搜索&热搜](search/hot.md)√ - - 搜索建议 + - [搜索建议](search/suggest.md)√ - [小黑屋](blackroom) - 基本信息 - [封禁公示](blackroom/banlist.md)√ - 仲裁信息 + - 仲裁操作 - [评论区](comment) - [评论区明细](comment/comment_list.md)√ - [操作](comment/action.md)√ @@ -153,7 +153,8 @@ PS:所有http协议地址均可使用https,文档中为了统一写作`http` - [其他](other) - [基于ip的地理位置查询](other/ip.md)√ - [获取当前时间戳](other/time_stamp.md)√ - - [分区在线人数](other/zone_online.md)√ +- [web端首页组件](web_widget) + - [分区在线人数](web_widget/zone_online.md)√ B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/readlist/rl207146)系列(更新状态:咕咕......),~~欢迎关注~~ @@ -165,7 +166,7 @@ B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/rea (重要的话说三遍,本人不承担任何责任) - +/> **--by [社会易姐QwQ](https://space.bilibili.com/293793435)** @@ -175,6 +176,8 @@ B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/rea 不了解json的请移步,[传送门](https://www.sojson.com/json/json_index.html) +不了解protobuf的请移步,[传送门](https://www.jianshu.com/p/a24c88c0526a ) + # 相关项目: 库及文档: diff --git a/article/like_coin_fav.md b/article/like_coin_fav.md index 001faf9..224430b 100644 --- a/article/like_coin_fav.md +++ b/article/like_coin_fav.md @@ -1,6 +1,6 @@ # 专栏投币&点赞&收藏 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie)** ## 点赞文章 diff --git a/audio/musicstream_url.md b/audio/musicstream_url.md index 62ddce1..b39ed37 100644 --- a/audio/musicstream_url.md +++ b/audio/musicstream_url.md @@ -11,7 +11,7 @@ | 2 | 高品质 320K | | 3 | 无损 FLAC (大会员) | -## 获取音频流URL(web端) +## 获取音频流URL(无法获取付费音频)(web端) > http://www.bilibili.com/audio/music-service-c/web/url diff --git a/comment/action.md b/comment/action.md index e5fa95b..a573adc 100644 --- a/comment/action.md +++ b/comment/action.md @@ -1,8 +1,8 @@ # 评论区操作 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie)** -使用该登录token进行评论用户识别与操作鉴权 +使用该登录token识别用户身份 ## 发表评论 diff --git a/creativecenter/railgun.md b/creativecenter/railgun.md index a939b87..f4c956d 100644 --- a/creativecenter/railgun.md +++ b/creativecenter/railgun.md @@ -1,6 +1,6 @@ # 电磁力相关 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie或APP)** 电磁力每周日下午刷新 diff --git a/creativecenter/statistics&data.md b/creativecenter/statistics&data.md index de4ba6b..ac0dcc4 100644 --- a/creativecenter/statistics&data.md +++ b/creativecenter/statistics&data.md @@ -1,6 +1,6 @@ # 统计与数据 -本页所有操作均需登录(SESSDATA) +本页所有操作均需登录(Cookie) 统计与数据次日中午12刷新 diff --git a/danmaku/danmaku_proto.md b/danmaku/danmaku_proto.md index 248f4d6..50ae6f0 100644 --- a/danmaku/danmaku_proto.md +++ b/danmaku/danmaku_proto.md @@ -16,7 +16,7 @@ 只能返回普通和高级弹幕,代码(BAS)弹幕请从云推荐弹幕中获取 -**注:仅获取6min的整数倍时间内的弹幕(如第一包中弹幕`progress`值域为0-360000)** +**注:仅获取6min的整数倍时间内的弹幕,6min内最多弹幕数为6000条(如第一包中弹幕`progress`值域为0-360000)** **url参数:** diff --git a/danmaku/snapshot.md b/danmaku/snapshot.md index b03a9b6..c40c03d 100644 --- a/danmaku/snapshot.md +++ b/danmaku/snapshot.md @@ -1,4 +1,4 @@ -# +# 弹幕快照 # 获取弹幕快照 diff --git a/electric/WeChat&Alipay.md b/electric/WeChat&Alipay.md index ac08c9e..029e584 100644 --- a/electric/WeChat&Alipay.md +++ b/electric/WeChat&Alipay.md @@ -1,6 +1,6 @@ # 微信&支付宝方式充电 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie)** diff --git a/emote/action.md b/emote/action.md index 28e8e06..f1c7cf1 100644 --- a/emote/action.md +++ b/emote/action.md @@ -1,6 +1,6 @@ # 表情操作 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie)** ## 添加表情包 diff --git a/history&toview/history.md b/history&toview/history.md index 3ccb0f8..97510d2 100644 --- a/history&toview/history.md +++ b/history&toview/history.md @@ -2,7 +2,7 @@ -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie)** ## 获取历史记录列表(视频、直播、专栏) diff --git a/imgs/class.svg b/imgs/class.svg new file mode 100644 index 0000000..51797d1 --- /dev/null +++ b/imgs/class.svg @@ -0,0 +1,7 @@ + + + \ No newline at end of file diff --git a/imgs/collect.svg b/imgs/collect.svg new file mode 100644 index 0000000..b382480 --- /dev/null +++ b/imgs/collect.svg @@ -0,0 +1,9 @@ + + + \ No newline at end of file diff --git a/imgs/up_face.jpg b/imgs/up_face.jpg new file mode 100644 index 0000000..26b579c Binary files /dev/null and b/imgs/up_face.jpg differ diff --git a/live/manage.md b/live/manage.md index 1ee83f3..554a9bc 100644 --- a/live/manage.md +++ b/live/manage.md @@ -1,6 +1,6 @@ # 直播间管理 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie)** ## 更新直播间标题 diff --git a/search/hot.md b/search/hot.md index 13f9ee6..b901019 100644 --- a/search/hot.md +++ b/search/hot.md @@ -72,7 +72,7 @@ curl 'http://api.bilibili.com/x/web-interface/search/default' | --------- | ----- | ------------ | ------------- | | exp_str | str | ??? | | | code | num | 返回值 | 0:成功 | -| cost | obj | 响应时间? | | +| cost | obj | 详细搜索用时 | 大概是吧? | | seid | str | 搜索seID | | | timestamp | num | 榜单统计时间 | 时间戳 | | message | str | 错误信息 | 默认为success | diff --git a/search/search_request.md b/search/search_request.md index 3b85bef..cf7cfc4 100644 --- a/search/search_request.md +++ b/search/search_request.md @@ -14,9 +14,9 @@ **url参数:** -| 参数名 | 类型 | 内容 | 备注 | -| ------- | ---- | ---------------- | ---- | -| keyword | str | 需要搜索的关键词 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------- | ---- | ---------------- | ------ | ---- | +| keyword | str | 需要搜索的关键词 | 必要 | | **json回复:** @@ -40,7 +40,7 @@ | numPages | num | 分页数 | 最大值为50 | | suggest_keyword | str | 空 | **作用尚不明确** | | rqt_type | str | search | **作用尚不明确** | -| cost_time | obj | 详细搜索用时 | 大概 | +| cost_time | obj | 详细搜索用时 | 大概是吧? | | exp_list | obj | ??? | **作用尚不明确** | | egg_hit | num | 0 | **作用尚不明确** | | pageinfo | obj | 分类页数信息 | | diff --git a/search/suggest.md b/search/suggest.md new file mode 100644 index 0000000..cb3a6aa --- /dev/null +++ b/search/suggest.md @@ -0,0 +1,177 @@ +# 搜索建议 + +## 获取搜索建议关键词(web端) + +> http://s.search.bilibili.com/main/suggest + +*请求方式:GET* + +搜索建议最多提供10个候选关键词 + +搜索建议内容可为任意语言(中 英 日等....),中文拼音支持全拼联想词 + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| --------- | ---- | ---------------------- | ------ | ------------------------ | +| term | str | 需要获得建议的输入内容 | 必要 | | +| main_ver | str | v1 | 非必要 | 固定为`v1` | +| highlight | str | 任意 | 非必要 | 有此项开启关键词高亮标签 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ------------ | ------------ | +| code | num | 返回值 | 0:成功 | +| cost | obj | 详细搜索用时 | 大概是吧? | +| result | obj | 搜索建议结果 | | +| page caches | obj | ??? | 作用尚不明确 | +| sengine | obj | ??? | 作用尚不明确 | +| stoken | str | ??? | 作用尚不明确 | + +`cost`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | -------- | ---- | +| about | obj | 套了个娃 | | + +`cost`中的`about`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ---- | ---- | +| params_check | str | | | +| total | str | | | +| main_handler | str | | | + +`result`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ----- | -------- | ---- | +| tag | array | 套了个娃 | | + +`result`中的`tag`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------------- | ---------------------- | +| 0 | obj | 第1建议关键词 | | +| n | obj | 第(n+1)建议关键词 | 按照相关程度与热度顺序 | +| 9 | obj | 第10建议关键词 | 最后一项 | + +`tag`数组中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---------- | ------------------------------------------------------------ | +| value | str | 关键词内容 | | +| ref | num | 0 | 作用尚不明确 | +| name | str | 显示内容 | 在无高亮显示时与`value`相同
有高亮显示时带有``的xml标签 | +| spid | num | ??? | 作用尚不明确 | + +`page caches`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | ---- | ------------ | +| save cache | str | no | 作用尚不明确 | + +`sengine`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---- | ------------ | +| usage | num | 0 | 作用尚不明确 | + +**示例:** + +获取关于`lei`的搜索建议,关键词带有高亮 + +```shell +curl -G 'http://s.search.bilibili.com/main/suggest'\ +--data-urlencode 'term=lei'\ +--data-urlencode 'main_ver=v1'\ +--data-urlencode 'highlight=' +``` + +```json +{ + "code": 0, + "cost": { + "about": { + "params_check": "0.000103", + "total": "0.011644", + "main_handler": "0.011472" + } + }, + "result": { + "tag": [ + { + "value": "雷军", + "ref": 0, + "name": "雷军", + "spid": 1 + }, + { + "value": "雷之律者", + "ref": 0, + "name": "雷之律者", + "spid": 5 + }, + { + "value": "LEI神", + "ref": 0, + "name": "LEI神", + "spid": 5 + }, + { + "value": "LEIGH ELLEXSON", + "ref": 0, + "name": "LEIGH ELLEXSON", + "spid": 5 + }, + { + "value": "LEICA Q2", + "ref": 0, + "name": "LEICA Q2", + "spid": 5 + }, + { + "value": "LEIGHANNE", + "ref": 0, + "name": "LEIGHANNE", + "spid": 0 + }, + { + "value": "雷达探测姬", + "ref": 0, + "name": "雷达探测姬", + "spid": 5 + }, + { + "value": "雷律", + "ref": 0, + "name": "雷律", + "spid": 5 + }, + { + "value": "雷霆嘎巴", + "ref": 0, + "name": "雷霆嘎巴", + "spid": 5 + }, + { + "value": "雷霆沙赞", + "ref": 0, + "name": "雷霆沙赞", + "spid": 5 + } + ] + }, + "page caches": { + "save cache": "no" + }, + "sengine": { + "usage": 0 + }, + "stoken": "12344377692164099019" +} +``` + diff --git a/user/space.md b/user/space.md index 334265f..8cb2f0d 100644 --- a/user/space.md +++ b/user/space.md @@ -2178,6 +2178,8 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check ## 收藏 + + ### 查询用户创建的视频收藏夹 > http://api.bilibili.com/x/v3/fav/folder/created/list-all @@ -2896,3 +2898,4 @@ curl -G 'http://space.bilibili.com/ajax/tags/getSubList'\ } } ``` + diff --git a/video/recommend.md b/video/recommend.md index 644fc90..624b0fd 100644 --- a/video/recommend.md +++ b/video/recommend.md @@ -1,6 +1,6 @@ # 视频推荐 -## 获取单视频推荐列表 +## 获取单视频推荐列表(web端) > http://api.bilibili.com/x/web-interface/archive/related diff --git a/other/zone_online.md b/web_widget/zone_online.md similarity index 100% rename from other/zone_online.md rename to web_widget/zone_online.md