From 8d956bab82eedde202c15114e07eae5d20d67c86 Mon Sep 17 00:00:00 2001
From: MidnightCrowing <110297461+MidnightCrowing@users.noreply.github.com>
Date: Sun, 7 Jul 2024 00:30:29 +0800
Subject: [PATCH] add follow_up_live.md (#1048)
---
README.md | 1 +
docs/live/follow_up_live.md | 161 ++++++++++++++++++++++++++++++++++++
docs/live/info.md | 4 +-
3 files changed, 164 insertions(+), 2 deletions(-)
create mode 100644 docs/live/follow_up_live.md
diff --git a/README.md b/README.md
index 7fc8767756..b716ae55b3 100644
--- a/README.md
+++ b/README.md
@@ -237,6 +237,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
- [ ] [直播红包](docs/live/redpocket.md)
- [ ] [直播间用户实用 API](docs/live/user.md)
- [x] [直播间禁言相关](docs/live/silent_user_manage.md)
+ - [ ] [关注UP直播情况](docs/live/follow_up_live)
- [ ] [转正答题](docs/newbie_exam)
- [x] [查询信息](docs/newbie_exam/info.md)
- [x] [拉取题目](docs/newbie_exam/fetch.md)
diff --git a/docs/live/follow_up_live.md b/docs/live/follow_up_live.md
new file mode 100644
index 0000000000..ed91573799
--- /dev/null
+++ b/docs/live/follow_up_live.md
@@ -0,0 +1,161 @@
+# 关注UP直播情况
+
+## 用户关注的所有UP的直播情况
+
+> https://api.bilibili.com/x/space/wbi/acc/info
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**URL参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|---------|-----|------|-----|-------|
+| page | num | 页码 | 非必要 | 默认为`1` |
+| page_size | num | 每页的数据数量 | 非必要 | 有效值`1`-`10`, 默认为`10` |
+| ignoreRecord | num | | | **尚不明确**
一般为`1` |
+| hit_ab | bool | | | **尚不明确**
建议用`true`, 不填为`false` |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|-----------------|
+| code | num | 返回值 | `0`：成功
`-101`：错误 |
+| message | str | 错误信息 | |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|-----------------|
+| title | str | 标题 | |
+| pageSize | num | 每页的数据数量 | |
+| totalPage | num | 分页数量 | |
+| list | obj | UP直播情况列表 | |
+| count | num | 曾直播过的UP数量 | |
+| never_lived_count | num | 未直播过的UP数量 | |
+| live_count | num | 正在直播的UP数量 | |
+| never_lived_faces | list | | **尚不明确** |
+
+`list`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|--------------|-----|-----|-----------|
+| roomid | num | 房间号 | |
+| uid | num | 主播uid | |
+| uname | str | 主播名 | |
+| title | str | 直播标题 | |
+| face | str | 主播头像 | |
+| live_status | num | 是否正在直播 | `0`: 未直播
`1`: 正在直播 |
+| record_num | num | | **尚不明确**
一般为0 |
+| recent_record_id | str | | **尚不明确**
一般为空 |
+| is_attention | num | | **尚不明确**
一般为1 |
+| clipnum | num | | **尚不明确**
一般为0 |
+| fans_num | num | | **尚不明确**
一般为0 |
+| area_name | str | | **尚不明确**
一般为空 |
+| area_value | str | | **尚不明确**
一般为空 |
+| tags | str | | **尚不明确**
一般为空 |
+| recent_record_id_v2 | str | | **尚不明确**
一般为空 |
+| record_num_v2 | num | | **尚不明确**
一般为0 |
+| record_live_time | num | 主播上一次直播结束的时间戳 | 正在直播时, 值为`0` |
+| area_name_v2 | str | 频道的名称 | |
+| room_news | str | 房间公告 | |
+| switch | bool | | **尚不明确** |
+| watch_icon | str | | **尚不明确** |
+| text_small | str | | **尚不明确**
当主播正在直播时, 为在线人数(可能) |
+| room_cover | str | 房间封面图片的URL | |
+| parent_area_id | num | 父分区id | |
+| area_id | num | 分区id | |
+
+**示例：**
+
+```shell
+curl -G 'https://api.live.bilibili.com/xlive/web-ucenter/user/following' \
+ -b 'SESSDATA=xxx' \
+ --data-urlencode 'page=1' \
+ --data-urlencode 'page_size=2' \
+ --data-urlencode 'ignoreRecord=1' \
+ --data-urlencode 'hit_ab=true'
+```
+
+
+查看响应示例：
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "title": "哔哩哔哩直播 - 我的关注",
+ "pageSize": 2,
+ "totalPage": 26,
+ "list": [
+ {
+ "roomid": 544853,
+ "uid": 686127,
+ "uname": "籽岷",
+ "title": "尝试双机位",
+ "face": "https://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp",
+ "live_status": 0,
+ "record_num": 0,
+ "recent_record_id": "",
+ "is_attention": 1,
+ "clipnum": 0,
+ "fans_num": 0,
+ "area_name": "",
+ "area_value": "",
+ "tags": "",
+ "recent_record_id_v2": "",
+ "record_num_v2": 0,
+ "record_live_time": 1720011626,
+ "area_name_v2": "新游推荐",
+ "room_news": "",
+ "switch": true,
+ "watch_icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png",
+ "text_small": "10.9万",
+ "room_cover": "http://i0.hdslb.com/bfs/live/new_room_cover/6c89c41d7695a080d31ae21c128f7759a7f419e5.jpg",
+ "parent_area_id": 6,
+ "area_id": 889
+ },
+ {
+ "roomid": 21686237,
+ "uid": 456664753,
+ "uname": "央视新闻",
+ "title": "央视新闻的直播间",
+ "face": "https://i1.hdslb.com/bfs/face/38a8db1c187b64a1412fafffbf350f8a3f436371.jpg",
+ "live_status": 0,
+ "record_num": 0,
+ "recent_record_id": "",
+ "is_attention": 1,
+ "clipnum": 0,
+ "fans_num": 0,
+ "area_name": "",
+ "area_value": "",
+ "tags": "",
+ "recent_record_id_v2": "",
+ "record_num_v2": 0,
+ "record_live_time": 1720001717,
+ "area_name_v2": "社科法律心理",
+ "room_news": "",
+ "switch": false,
+ "watch_icon": "https://i0.hdslb.com/bfs/live/0b265af1af0a77abc47aa3b8f1a5c0769d8bd23b.png",
+ "text_small": "0",
+ "room_cover": "http://i0.hdslb.com/bfs/live/d650d0e6e49397ea71d630be0a0e686679df16d8.jpg",
+ "parent_area_id": 11,
+ "area_id": 376
+ }
+ ],
+ "count": 52,
+ "never_lived_count": 30,
+ "live_count": 0,
+ "never_lived_faces": []
+ }
+}
+
+```
+
+
\ No newline at end of file
diff --git a/docs/live/info.md b/docs/live/info.md
index 3e05edc1d5..db3f03acf5 100644
--- a/docs/live/info.md
+++ b/docs/live/info.md
@@ -590,7 +590,7 @@ curl -G 'https://api.live.bilibili.com/live_user/v1/Master/info' \
**示例：**
-查询用户`mid=672328094的直播间信息
+查询用户`mid=672328094`的直播间信息
```shell
# GET方式
@@ -779,7 +779,7 @@ curl 'https://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids' \
**示例：**
-查询room_id=3的直播间信息
+查询`room_id=3`的直播间信息
```shell
curl -L -X GET 'https://api.live.bilibili.com/xlive/web-room/v2/index/getRoomPlayInfo?room_id=3&protocol=0,1&format=0,1,2&codec=0,1&qn=10000'