返回提交历史
Modified
README.md
+1
-0
Modified
docs/live/recommend.md
+66
-0
XFEstudio/bilibili-API-collect
fix(live/recommend.md): missing response and entrance
bc7efd3
代码差异
2 个文件
+67
-0
@@ -243,6 +243,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
243
243
- [x] [播放 & 下载地址（视频流）](docs/cheese/videostream_url.md)
244
244
- [ ] [直播](docs/live)
245
245
- [ ] [直播间基本信息](docs/live/info.md)
246
- [ ] [直播推荐](docs/live/recommend.md)
246
247
- [ ] [直播分区](docs/live/live_area.md)
247
248
- [ ] [直播间管理](docs/live/manage.md)
248
249
- [ ] 直播间操作
@@ -13,6 +13,72 @@
13
13
| platform | string | 平台类型 | 必要 | 默认为 `web`, 实测可为任意非空串 |
14
14
| web_location | string | `333.1007` | 非必要 | |
15
15
16
**JSON 回复:**
17
18
根对象:
19
20
| 字段 | 类型 | 内容 | 备注 |
21
| ------- | ------ | -------- | ---- |
22
| code | number | 返回值 | 0: 成功 |
23
| message | string | 错误信息 | 默认为 `0` |
24
| ttl | number | 1 | |
25
26
`data` 对象:
27
28
| 字段 | 类型 | 内容 | 备注 |
29
| ------------------- | ------ | ------------- | -------- |
30
| recommend_room_list | Array | 推荐房间列表 | 套了个娃 |
31
| top_room_id | number | 置顶直播间号? | |
32
33
`data` 对象中 `recommend_room_list` 数组中的对象:
34
35
| 字段 | 类型 | 内容 | 备注 |
36
| ---------------------- | -------------- | ---------------- | ---- |
37
| head_box | object \| null | 头像框 | 无则为 `null` |
38
| area_v2_id | number | 分区 ID | |
39
| area_v2_parent_id | number | 父分区 ID | |
40
| area_v2_name | string | 分区名称 | |
41
| area_v2_parent_name | string | 父分区名称 | |
42
| broadcast_type | number | 广播类型? | |
43
| cover | string | 封面 URL | |
44
| link | string | 直播间链接 | 仅 `pathname` 与 `query` 部分 |
45
| online | number | 观看人数 | |
46
| pendant_Info | object | ??? | 作用尚不明确 |
47
| roomid | number | 直播间 ID | |
48
| title | string | 直播间标题 | |
49
| uname | string | 主播用户名 | |
50
| face | string | 主播头像 URL | |
51
| verify | object | 认证信息 | 参见 [用户基本信息](../user/info.md) |
52
| uid | number | 主播用户 mid | |
53
| keyframe | string | 关键帧 URL | |
54
| is_auto_play | number | 是否自动播放? | |
55
| head_box_type | number | 头像框类型? | |
56
| flag | number | 标记? | 作用尚不明确 |
57
| session_id | string | 会话 ID? | 格式为: 本次请求相同的小写无分隔 UUID + 下划线 + 大写以连字符分隔的 UUID |
58
| show_callback | string | 展示回调 URL? | |
59
| click_callback | string | 点击回调 URL? | |
60
| special_id | number | 特殊 ID? | 作用尚不明确 |
61
| watched_show | object | 观看展示 | 见下 |
62
| is_nft | number | 是否为 NFT 头像? | |
63
| nft_dmark | string | ??? | 作用尚不明确 |
64
| is_ad | boolean | 是否为广告 | |
65
| ad_transparent_content | unknown | ??? | 作用尚不明确 |
66
| show_ad_icon | boolean | 显示广告图标 | |
67
| status | boolean | 状态? | 作用尚不明确 |
68
| followers | number | 0 | 作用尚不明确 |
69
70
`recommend_room_list` 数组中的对象中的 `watched_show` 对象:
71
72
| 字段 | 类型 | 内容 | 备注 |
73
| ------------- | ------- | -------- | ---- |
74
| switch | boolean | ??? | 作用尚不明确 |
75
| num | number | 看过人数 | |
76
| text_small | string | 小文本 | xxx |
77
| text_large | string | 大文本 | xxx人看过 |
78
| icon | string | 图标 URL | 浅色线条眼睛图标 |
79
| icon_location | number | 0 | |
80
| icon_web | string | 图标 URL | 深色线条眼睛图标 (Web 端) |
81
16
82
**示例:**
17
83
18
84
```shell