增加搜索建议并勘误

2024-12-26 12:30:07 +08:00 · 2020-07-30 23:29:40 +08:00 · 2020-07-30 23:29:40 +08:00 · 0b80143311
commit 0b80143311
parent 0183d881ba
21 changed files with 224 additions and 25 deletions
--- a/README.md
+++ b/README.md
@ -1,6 +1,4 @@
-<p align="center">
-    <img src="http://i0.hdslb.com/bfs/album/1ba8228cc208a12ac17f73a160081a0918ab7d14.png" width="250" height="200"/>
-<p/>
+<center><img src="./imgs/Mylogo.png" width="250" height="200"></center>
 <h1 align="center">哔哩哔哩-API收集整理</h1>
 <p align="center">
    <a href="https://github.com/SocialSisterYi/bilibili-API-collect/issues" style="text-decoration:none">
@ -17,6 +15,7 @@
    </a>
 </p>

+
 <h3 align="center">野生API文档</h3> 
 <h3 align="center">不断更新中....</h3> 
 本项目旨在对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

 （重要的话说三遍，本人不承担任何责任）

-<img src="https://i2.hdslb.com/bfs/face/480e2e98513aaeb65d2f2c76dbae750c4de722e9.jpg@100w_100h" />
+<img src="imgs/up_face.jpg" width="100" height="100">/>

 **--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 )
+
 # 相关项目：

 库及文档：
--- a/article/like_coin_fav.md
+++ b/article/like_coin_fav.md
@ -1,6 +1,6 @@
 # 专栏投币&点赞&收藏

-**本页所有操作均需登录（SESSDATA）**
+**本页所有操作均需登录（Cookie）**

 ## 点赞文章

--- 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

--- a/comment/action.md
+++ b/comment/action.md
@ -1,8 +1,8 @@
 # 评论区操作

-**本页所有操作均需登录（SESSDATA）**
+**本页所有操作均需登录（Cookie）**

-使用该登录token进行评论用户识别与操作鉴权
+使用该登录token识别用户身份

 ## 发表评论

--- a/creativecenter/railgun.md
+++ b/creativecenter/railgun.md
@ -1,6 +1,6 @@
 # 电磁力相关

-**本页所有操作均需登录（SESSDATA）**
+**本页所有操作均需登录（Cookie或APP）**

 电磁力每周日下午刷新

--- a/creativecenter/statistics&data.md
+++ b/creativecenter/statistics&data.md
@ -1,6 +1,6 @@
 # 统计与数据

-本页所有操作均需登录（SESSDATA）
+本页所有操作均需登录（Cookie）

 统计与数据次日中午12刷新

--- 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参数：**

--- a/danmaku/snapshot.md
+++ b/danmaku/snapshot.md
@ -1,4 +1,4 @@
-# 
+#  弹幕快照

 # 获取弹幕快照

--- a/electric/WeChat&Alipay.md
+++ b/electric/WeChat&Alipay.md
@ -1,6 +1,6 @@
 # 微信&支付宝方式充电

-**本页所有操作均需登录（SESSDATA）**
+**本页所有操作均需登录（Cookie）**

 <img src="/imgs/battery-100.png" width="100" height="100"/>

--- a/emote/action.md
+++ b/emote/action.md
@ -1,6 +1,6 @@
 # 表情操作

-**本页所有操作均需登录（SESSDATA）**
+**本页所有操作均需登录（Cookie）**

 ## 添加表情包

--- a/history&toview/history.md
+++ b/history&toview/history.md
@ -2,7 +2,7 @@

 <img src="/imgs/history.png" width="25" height="25"/>

-**本页所有操作均需登录（SESSDATA）**
+**本页所有操作均需登录（Cookie）**

 ## 获取历史记录列表（视频、直播、专栏）

--- a/imgs/class.svg
+++ b/imgs/class.svg
@ -0,0 +1,7 @@
+<svg  xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024">
+<path fill="#0BA395" d="M107.7,3.2C45,16.5,1,68.8-0.3,134.2v582c1.3,65.3,45.3,117.7,108,131V3.2z M625.7,0.2h-452v850h452
+	c76-2.7,132.7-58,134-134v-582C758.4,58.2,701.7,2.8,625.7,0.2z M385.7,117.2c0-18.7,14.3-33,33-33h213c18.7,0,31.7,14.3,33,33v237
+	c-0.7,13.3-6.7,23.3-18,30c-10.7,4-23.3,4.7-34-2l-92-63l-82,62c-22.7,14.7-51.7-0.3-53-27V117.2z M670.7,704.2
+	c0,18.7-14.3,33-33,33h-354c-42.1,0-41.2-63.1,0-66h354C656.4,672.5,670.7,685.5,670.7,704.2z M670.7,555.2c0,18.7-14.3,33-33,33
+	h-354c-42.1,0-41.2-63.1,0-66h354C656.4,523.5,670.7,536.5,670.7,555.2z"/>
+</svg>
--- a/imgs/collect.svg
+++ b/imgs/collect.svg
@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024">
+	<path fill="#F3A034" d="M646.6,837.1c-50.8,0-119.6-23.4-204.4-69.5l-0.2-0.1l-0.2,0.1c-84.7,45.8-153.4,69.1-204.2,69.1
+		c-36,0-63.8-11.7-82.8-34.6c-17.8-21.5-28.2-53.6-31.1-95.4c-2.9-41.8,1.7-94.5,13.8-156.5l0.1-0.3l-0.2-0.2
+		c-53.4-49.2-91.6-94.1-113.6-133.2c-21.9-39.1-28.3-73.6-19-102.7c9.4-29.2,35-53.7,76.1-72.8c41.2-19.1,99.1-33.4,172.1-42.4
+		l0.3,0l0.1-0.2c31.3-65.6,63.1-115.6,94.4-148.4C379,17.1,410.7,0.5,441.9,0.5c31.2,0,62.9,16.6,94.1,49.3
+		c31.3,32.8,63.1,82.7,94.4,148.4l0.1,0.2l0.3,0c73.2,9,131.2,23.3,172.5,42.4c41.2,19.1,66.9,43.6,76.2,72.9
+		c9.3,29,2.9,63.6-19.1,102.6c-22.1,39.2-60.4,84-113.9,133.2l-0.2,0.2l0.1,0.3c12,62.2,16.7,115,13.8,156.9
+		c-2.9,41.8-13.4,74-31.2,95.5C710.1,825.4,682.4,837.1,646.6,837.1z"/>
+</svg>
--- a/imgs/up_face.jpg
+++ b/imgs/up_face.jpg
--- a/live/manage.md
+++ b/live/manage.md
@ -1,6 +1,6 @@
 # 直播间管理

-**本页所有操作均需登录（SESSDATA）**
+**本页所有操作均需登录（Cookie）**

 ## 更新直播间标题

--- 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 |
--- 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   | 分类页数信息     |                  |
--- a/search/suggest.md
+++ 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`相同<br />有高亮显示时带有`<em class="suggest_high_light">`的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": "<em class=\"suggest_high_light\">LEI</em>神",
+                "spid": 5
+            },
+            {
+                "value": "LEIGH ELLEXSON",
+                "ref": 0,
+                "name": "<em class=\"suggest_high_light\">LEI</em>GH ELLEXSON",
+                "spid": 5
+            },
+            {
+                "value": "LEICA Q2",
+                "ref": 0,
+                "name": "<em class=\"suggest_high_light\">LEI</em>CA Q2",
+                "spid": 5
+            },
+            {
+                "value": "LEIGHANNE",
+                "ref": 0,
+                "name": "<em class=\"suggest_high_light\">LEI</em>GHANNE",
+                "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"
+}
+```
+
--- a/user/space.md
+++ b/user/space.md
@ -2178,6 +2178,8 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check

 ## 收藏

+<img src="/imgs/collect.svg" width="100" height="100" />
+
 ### 查询用户创建的视频收藏夹

 > http://api.bilibili.com/x/v3/fav/folder/created/list-all 
@ -2896,3 +2898,4 @@ curl -G 'http://space.bilibili.com/ajax/tags/getSubList'\
 	}
 }
 ```
+
--- a/video/recommend.md
+++ b/video/recommend.md
@ -1,6 +1,6 @@
 # 视频推荐

-## 获取单视频推荐列表
+## 获取单视频推荐列表（web端）

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

--- a/web_widget/zone_online.md
+++ b/web_widget/zone_online.md