返回提交历史
Modified
README.md
+1
-0
Added
docs/live/follow_up_live.md
+161
-0
Modified
docs/live/info.md
+2
-2
XFEstudio/bilibili-API-collect
add follow_up_live.md (#1048)
8d956ba
代码差异
3 个文件
+164
-2
@@ -237,6 +237,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
237
237
- [ ] [直播红包](docs/live/redpocket.md)
238
238
- [ ] [直播间用户实用 API](docs/live/user.md)
239
239
- [x] [直播间禁言相关](docs/live/silent_user_manage.md)
240
- [ ] [关注UP直播情况](docs/live/follow_up_live)
240
241
- [ ] [转正答题](docs/newbie_exam)
241
242
- [x] [查询信息](docs/newbie_exam/info.md)
242
243
- [x] [拉取题目](docs/newbie_exam/fetch.md)
@@ -0,0 +1,161 @@
1
# 关注UP直播情况
2
3
## 用户关注的所有UP的直播情况
4
5
> https://api.bilibili.com/x/space/wbi/acc/info
6
7
*请求方式：GET*
8
9
认证方式：Cookie（SESSDATA）
10
11
**URL参数：**
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
|---------|-----|------|-----|-------|
15
| page | num | 页码 | 非必要 | 默认为`1` |
16
| page_size | num | 每页的数据数量 | 非必要 | 有效值`1`-`10`, 默认为`10` |
17
| ignoreRecord | num | | | **尚不明确**<br />一般为`1` |
18
| hit_ab | bool | | | **尚不明确**<br />建议用`true`, 不填为`false` |
19
20
**json回复：**
21
22
根对象：
23
24
| 字段 | 类型 | 内容 | 备注 |
25
|---------|-----|------|-----------------|
26
| code | num | 返回值 | `0`：成功<br />`-101`：错误 |
27
| message | str | 错误信息 | |
28
| ttl | num | 1 | |
29
| data | obj | 信息本体 | |
30
31
`data`对象：
32
| 字段 | 类型 | 内容 | 备注 |
33
|---------|-----|------|-----------------|
34
| title | str | 标题 | |
35
| pageSize | num | 每页的数据数量 | |
36
| totalPage | num | 分页数量 | |
37
| list | obj | UP直播情况列表 | |
38
| count | num | 曾直播过的UP数量 | |
39
| never_lived_count | num | 未直播过的UP数量 | |
40
| live_count | num | 正在直播的UP数量 | |
41
| never_lived_faces | list | | **尚不明确** |
42
43
`list`对象：
44
45
| 字段 | 类型 | 内容 | 备注 |
46
|--------------|-----|-----|-----------|
47
| roomid | num | 房间号 | |
48
| uid | num | 主播uid | |
49
| uname | str | 主播名 | |
50
| title | str | 直播标题 | |
51
| face | str | 主播头像 | |
52
| live_status | num | 是否正在直播 | `0`: 未直播<br />`1`: 正在直播 |
53
| record_num | num | | **尚不明确**<br />一般为0 |
54
| recent_record_id | str | | **尚不明确**<br />一般为空 |
55
| is_attention | num | | **尚不明确**<br />一般为1 |
56
| clipnum | num | | **尚不明确**<br />一般为0 |
57
| fans_num | num | | **尚不明确**<br />一般为0 |
58
| area_name | str | | **尚不明确**<br />一般为空 |
59
| area_value | str | | **尚不明确**<br />一般为空 |
60
| tags | str | | **尚不明确**<br />一般为空 |
61
| recent_record_id_v2 | str | | **尚不明确**<br />一般为空 |
62
| record_num_v2 | num | | **尚不明确**<br />一般为0 |
63
| record_live_time | num | 主播上一次直播结束的时间戳 | 正在直播时, 值为`0` |
64
| area_name_v2 | str | 频道的名称 | |
65
| room_news | str | 房间公告 | |
66
| switch | bool | | **尚不明确** |
67
| watch_icon | str | | **尚不明确** |
68
| text_small | str | | **尚不明确**<br />当主播正在直播时, 为在线人数(可能) |
69
| room_cover | str | 房间封面图片的URL | |
70
| parent_area_id | num | 父分区id | |
71
| area_id | num | 分区id | |
72
73
**示例：**
74
75
```shell
76
curl -G 'https://api.live.bilibili.com/xlive/web-ucenter/user/following' \
77
-b 'SESSDATA=xxx' \
78
--data-urlencode 'page=1' \
79
--data-urlencode 'page_size=2' \
80
--data-urlencode 'ignoreRecord=1' \
81
--data-urlencode 'hit_ab=true'
82
```
83
84
<details>
85
<summary>查看响应示例：</summary>
86
87
```json
88
{
89
"code": 0,
90
"message": "0",
91
"ttl": 1,
92
"data": {
93
"title": "哔哩哔哩直播 - 我的关注",
94
"pageSize": 2,
95
"totalPage": 26,
96
"list": [
97
{
98
"roomid": 544853,
99
"uid": 686127,
100
"uname": "籽岷",
101
"title": "尝试双机位",
102
"face": "https://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp",
103
"live_status": 0,
104
"record_num": 0,
105
"recent_record_id": "",
106
"is_attention": 1,
107
"clipnum": 0,
108
"fans_num": 0,
109
"area_name": "",
110
"area_value": "",
111
"tags": "",
112
"recent_record_id_v2": "",
113
"record_num_v2": 0,
114
"record_live_time": 1720011626,
115
"area_name_v2": "新游推荐",
116
"room_news": "",
117
"switch": true,
118
"watch_icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png",
119
"text_small": "10.9万",
120
"room_cover": "http://i0.hdslb.com/bfs/live/new_room_cover/6c89c41d7695a080d31ae21c128f7759a7f419e5.jpg",
121
"parent_area_id": 6,
122
"area_id": 889
123
},
124
{
125
"roomid": 21686237,
126
"uid": 456664753,
127
"uname": "央视新闻",
128
"title": "央视新闻的直播间",
129
"face": "https://i1.hdslb.com/bfs/face/38a8db1c187b64a1412fafffbf350f8a3f436371.jpg",
130
"live_status": 0,
131
"record_num": 0,
132
"recent_record_id": "",
133
"is_attention": 1,
134
"clipnum": 0,
135
"fans_num": 0,
136
"area_name": "",
137
"area_value": "",
138
"tags": "",
139
"recent_record_id_v2": "",
140
"record_num_v2": 0,
141
"record_live_time": 1720001717,
142
"area_name_v2": "社科法律心理",
143
"room_news": "",
144
"switch": false,
145
"watch_icon": "https://i0.hdslb.com/bfs/live/0b265af1af0a77abc47aa3b8f1a5c0769d8bd23b.png",
146
"text_small": "0",
147
"room_cover": "http://i0.hdslb.com/bfs/live/d650d0e6e49397ea71d630be0a0e686679df16d8.jpg",
148
"parent_area_id": 11,
149
"area_id": 376
150
}
151
],
152
"count": 52,
153
"never_lived_count": 30,
154
"live_count": 0,
155
"never_lived_faces": []
156
}
157
}
158
159
```
160
161
</details>
@@ -590,7 +590,7 @@ curl -G 'https://api.live.bilibili.com/live_user/v1/Master/info' \
590
590
591
591
**示例：**
592
592
593
查询用户`mid=672328094的直播间信息
593
查询用户`mid=672328094`的直播间信息
594
594
595
595
```shell
596
596
# GET方式
@@ -779,7 +779,7 @@ curl 'https://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids' \
779
779
780
780
**示例：**
781
781
782
查询room_id=3的直播间信息
782
查询`room_id=3`的直播间信息
783
783
784
784
```shell
785
785
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'