From d6a08ce9550928cd14fbc3a5891c50a2837a9fd9 Mon Sep 17 00:00:00 2001
From: glyceryl <494192175@qq.com>
Date: Tue, 31 Dec 2024 17:48:10 +0800
Subject: [PATCH] =?UTF-8?q?docs/live/follow=5Fup=5Flive.md:=20=E6=B7=BB?=
=?UTF-8?q?=E5=8A=A0=E4=B8=80=E4=B8=AA=E7=94=A8=E4=BA=8E=E8=8E=B7=E5=8F=96?=
=?UTF-8?q?=E5=BC=80=E6=92=AD=E5=88=97=E8=A1=A8=E4=BF=A1=E6=81=AF=E7=9A=84?=
=?UTF-8?q?=E6=8E=A5=E5=8F=A3=EF=BC=88PC=E7=AB=AF=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/live/follow_up_live.md | 156 ++++++++++++++++++++++++++++++++++++
1 file changed, 156 insertions(+)
diff --git a/docs/live/follow_up_live.md b/docs/live/follow_up_live.md
index 5e88da5..8c7d0a1 100644
--- a/docs/live/follow_up_live.md
+++ b/docs/live/follow_up_live.md
@@ -158,4 +158,160 @@ curl -G 'https://api.live.bilibili.com/xlive/web-ucenter/user/following' \
```
+
+
+## 用户关注的所有UP且正在直播的列表（PC端）
+
+> https://api.live.bilibili.com/xlive/web-ucenter/v1/xfetter/GetWebList
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|------|----------------------------------|-----|------------------|
+| hit_ab | bool | 会影响到json回复中部分字段的值，具体的影响效果会在下表列出。 | 非必要 | 默认为true，不填为false |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|------------------|
+| code | num | 返回值 | 0：成功
1：参数错误 |
+| msg | str | 错误信息 | 默认为空 |
+| message | str | 错误信息 | 默认为空 |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|------|--------------|--------------------------------------------------------------------|
+| rooms | list | 正在直播的房间列表 | 受到url参数hit_ab的影响：
true时能够获取到全部正在开播的直播间列表，
false时只会获取到前10个。 |
+| list | list | 正在直播的房间列表 | 疑似与rooms字段的内容相同，并且同样受到url参数hit_ab的影响，受影响的效果同rooms字段。 |
+| count | num | 关注列表中正在直播的人数 | 受到url参数hit_ab的影响：hit_ab为true时为0 |
+| not_living_num | num | 关注列表中未开播的人数 | 受到url参数hit_ab的影响：hit_ab为false时为0 |
+
+`rooms`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|------|--------------|---------------------------------------------------------------|
+| title | num | 直播间标题 | |
+| room_id | num | 直播间真实id | |
+| uid | num | 目标用户mid | |
+| online | num | 观看人数 | 受url参数hit_ab的影响，hit_ab为true时为0 |
+| live_time | num | 已经直播的时长（单位为秒） | 受url参数hit_ab的影响，hit_ab为true时为0 |
+| live_status | num | 开播状态 | 0：未开播
1：直播中
2：轮播中 |
+| short_id | num | 直播间短id | 受url参数hit_ab的影响，hit_ab为true时为0 |
+| area | num | 分区id | 受url参数hit_ab的影响，hit_ab为true时为0 |
+| area_name | str | 分区名称 | |
+| area_v2_id | num | 二级分区id | |
+| area_v2_name | str | 二级分区名 | |
+| area_v2_parent_name | str | 二级父分区名 | |
+| area_v2_parent_id | num | 二级父分区id | |
+| uname | str | 用户名 | |
+| face | str | 用户头像图片链接 | |
+| tag_name | str | 标签名 | |
+| tags | str | 标签列表 | |
+| cover_from_user | str | 直播间封面图片链接 | 受url参数hit_ab的影响，hit_ab为true时为0 |
+| keyframe | str | 关键帧图片链接 | 用于网页端悬浮展示。受url参数hit_ab的影响，hit_ab为true时为0 |
+| lock_till | str | 未知 | 时间日期格式为：yyyy-MM-dd hh-mm-ss。
受url参数hit_ab的影响，hit_ab为true时为空字符串 |
+| hidden_till | str | 未知 | 时间日期格式为：yyyy-MM-dd hh-mm-ss。
受url参数hit_ab的影响，hit_ab为true时为空字符串 |
+| broadcast_type | num | 广播类型 | |
+| is_encrypt | bool | 直播间是否加密 | |
+| link | str | 直播间链接 | 受url参数hit_ab的影响，hit_ab为true时为空字符串 |
+| nickname | str | 用户昵称 | 受url参数hit_ab的影响，hit_ab为true时为空字符串 |
+| roomname | str | 直播间名称 | 受url参数hit_ab的影响，hit_ab为true时为空字符串 |
+| roomid | num | 直播间真实id | 受url参数hit_ab的影响，hit_ab为true时为0 |
+| liveTime | num | 开播时间 | 受url参数hit_ab的影响，hit_ab为true时为0 |
+
+**示例：**
+
+```shell
+curl -G 'https://api.live.bilibili.com/xlive/web-ucenter/v1/xfetter/GetWebList' \
+--header 'Cookie: SESSDATA=xxx' \
+--data-urlencode 'hit_ab=false'
+```
+
+
+查看响应示例：
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "rooms": [
+ {
+ "title": "虚拟区优质跨年直播展演",
+ "room_id": 21496316,
+ "uid": 441666939,
+ "online": 2308,
+ "live_time": 17313,
+ "live_status": 1,
+ "short_id": 36,
+ "area": 6,
+ "area_name": "生活娱乐",
+ "area_v2_id": 744,
+ "area_v2_name": "虚拟Singer",
+ "area_v2_parent_name": "虚拟主播",
+ "area_v2_parent_id": 9,
+ "uname": "虚拟区官方频道",
+ "face": "https://i0.hdslb.com/bfs/face/a26b52bc7837ce6867802575d300ed70d5e6f2d5.jpg",
+ "tag_name": "",
+ "tags": "",
+ "cover_from_user": "https://i0.hdslb.com/bfs/live/new_room_cover/5d7a4526062cf1dc4e88e016638a856c1ac7db03.jpg",
+ "keyframe": "https://i0.hdslb.com/bfs/live-key-frame/keyframe12311645000021496316pkuk08.jpg",
+ "lock_till": "0000-00-00 00:00:00",
+ "hidden_till": "0000-00-00 00:00:00",
+ "broadcast_type": 0,
+ "is_encrypt": false,
+ "link": "https://live.bilibili.com/21496316?broadcast_type=0",
+ "nickname": "虚拟区官方频道",
+ "roomname": "虚拟区优质跨年直播展演",
+ "roomid": 21496316,
+ "liveTime": 1735617438
+ }
+ ],
+ "list": [
+ {
+ "title": "虚拟区优质跨年直播展演",
+ "room_id": 21496316,
+ "uid": 441666939,
+ "online": 2308,
+ "live_time": 17313,
+ "live_status": 1,
+ "short_id": 36,
+ "area": 6,
+ "area_name": "生活娱乐",
+ "area_v2_id": 744,
+ "area_v2_name": "虚拟Singer",
+ "area_v2_parent_name": "虚拟主播",
+ "area_v2_parent_id": 9,
+ "uname": "虚拟区官方频道",
+ "face": "https://i0.hdslb.com/bfs/face/a26b52bc7837ce6867802575d300ed70d5e6f2d5.jpg",
+ "tag_name": "",
+ "tags": "",
+ "cover_from_user": "https://i0.hdslb.com/bfs/live/new_room_cover/5d7a4526062cf1dc4e88e016638a856c1ac7db03.jpg",
+ "keyframe": "https://i0.hdslb.com/bfs/live-key-frame/keyframe12311645000021496316pkuk08.jpg",
+ "lock_till": "0000-00-00 00:00:00",
+ "hidden_till": "0000-00-00 00:00:00",
+ "broadcast_type": 0,
+ "is_encrypt": false,
+ "link": "https://live.bilibili.com/21496316?broadcast_type=0",
+ "nickname": "虚拟区官方频道",
+ "roomname": "虚拟区优质跨年直播展演",
+ "roomid": 21496316,
+ "liveTime": 1735617438
+ }
+ ],
+ "count": 1,
+ "not_living_num": 0
+ }
+}
+```
+
\ No newline at end of file