返回提交历史
Modified
README.md
+1
-0
Added
live/live_bill.md
+333
-0
XFEstudio/bilibili-API-collect
增加了直播流水获取的接口
6ba5aa9
代码差异
2 个文件
+334
-0
@@ -193,6 +193,7 @@ PS：所有 rest api 均可使用 https，文档中为了统一写作`http` (除
193
193
- [ ] 直播间操作
194
194
- [ ] [直播视频流](live/live_stream.md)
195
195
- [ ] [直播信息流](live/message_stream.md)
196
- [ ] [直播流水](live/live_bill.md)
196
197
- [ ] [转正答题](newbie_exam)
197
198
- [x] [查询信息](newbie_exam/info.md)
198
199
- [x] [拉取题目](newbie_exam/fetch.md)
@@ -0,0 +1,333 @@
1
# 直播流水
2
3
- [获取所有礼物列表](#获取所有礼物列表)
4
- [获取流水](#获取流水)
5
6
## 获取所有礼物列表
7
8
> https://api.live.bilibili.com/gift/v1/master/getGiftTypes
9
10
*请求方式：GET*
11
12
认证方式：Cookie（SESSDATA）
13
14
**json回复：**
15
16
根对象：
17
18
| 字段 | 类型 | 内容 | 备注 |
19
| ------- | ----- | -------- | -------------- |
20
| code | num | 返回值 | 0：成功 |
21
| msg | str | 错误信息 | 默认为 success |
22
| message | str | 错误信息 | 默认为 success |
23
| data | array | 礼物列表 | |
24
25
`data` 数组：
26
27
| 字段 | 类型 | 内容 | 备注 |
28
| --------- | ---- | -------- | ------------------------------------------------------------------------------ |
29
| gift_id | num | 礼物 id | |
30
| gift_name | str | 礼物名称 | |
31
| price | num | 瓜子数量 | 电池礼物为金瓜子数量，银瓜子礼物为银瓜子数量。 （金瓜子数量 / 100 = 电池数量） |
32
33
*注：特殊礼物如舰长、提督、总督等没有 `price` 字段*
34
35
<details>
36
<summary>查看响应示例：</summary>
37
38
```json
39
{
40
"code": 0,
41
"msg": "success",
42
"message": "success",
43
"data": [
44
{
45
"gift_id": 10001,
46
"gift_name": "总督"
47
},
48
{
49
"gift_id": 10002,
50
"gift_name": "提督"
51
},
52
{
53
"gift_id": 10003,
54
"gift_name": "舰长"
55
},
56
{
57
"gift_id": 12000,
58
"gift_name": "醒目留言"
59
},
60
{
61
"gift_id": 1,
62
"price": 100,
63
"gift_name": "辣条"
64
},
65
{
66
"gift_id": 3,
67
"price": 9900,
68
"gift_name": "B坷垃"
69
},
70
{
71
"gift_id": 6,
72
"price": 1000,
73
"gift_name": "亿圆"
74
},
75
{
76
"gift_id": 30426,
77
"price": 0,
78
"gift_name": "BLS能量石"
79
},
80
{
81
"gift_id": 30706,
82
"price": 1000,
83
"gift_name": "生日快乐"
84
},
85
{
86
"gift_id": 30707,
87
"price": 5200,
88
"gift_name": "生日蛋糕"
89
},
90
{
91
"gift_id": 30708,
92
"price": 52000,
93
"gift_name": "生日王冠"
94
},
95
{
96
"gift_id": 31049,
97
"price": 6600,
98
"gift_name": "干杯"
99
},
100
{
101
"gift_id": 31116,
102
"price": 6600,
103
"gift_name": "干杯"
104
},
105
{
106
"gift_id": 31251,
107
"price": 6600,
108
"gift_name": "干杯"
109
},
110
{
111
"gift_id": 31531,
112
"price": 0,
113
"gift_name": "PK票"
114
},
115
{
116
"gift_id": 31588,
117
"price": 19900,
118
"gift_name": "星河入梦"
119
},
120
{
121
"gift_id": 31589,
122
"price": 131400,
123
"gift_name": "我星永恒"
124
},
125
{
126
"gift_id": 32276,
127
"price": 0,
128
"gift_name": "粉丝团灯牌"
129
},
130
...
131
]
132
}
133
```
134
135
</details>
136
137
---
138
139
## 获取流水
140
141
> https://api.live.bilibili.com/xlive/revenue/v1/giftStream/getReceivedGiftStreamNextList
142
143
*请求方式：GET*
144
145
认证方式：Cookie（SESSDATA）
146
147
请求参数：
148
149
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
150
| ---------- | ------------- | ----------------------- | ---------- |
151
| limit | num | 一页有多少条目 | 必要 | |
152
| coin_type | num | 礼物类型 | 必要 | 0 为所有，1 为电池礼物，2 为银瓜子礼物 |
153
| begin_time | date / string | 流水的日期 | 必要 | 格式为 yyyy-MM-dd |
154
| uname | string | 筛选的用户名 | 非必要 | |
155
| last_id | num | 上一页页末的礼物列表 id | 翻页时必要 | 见下方 `list` 数组说明 |
156
| gift_id | num | 筛选的礼物 id | |
157
158
请求示例：`https://api.live.bilibili.com/xlive/revenue/v1/giftStream/getReceivedGiftStreamNextList?limit=20&coin_type=0&begin_time=2023-01-01`
159
160
请求示例（翻页时）：`https://api.live.bilibili.com/xlive/revenue/v1/giftStream/getReceivedGiftStreamNextList?last_id=13834493&limit=20&coin_type=0&begin_time=2023-01-01`
161
162
**json 回复：**
163
164
根对象：
165
166
| 字段 | 类型 | 内容 | 备注 |
167
| ------- | ------ | -------- | -------------- |
168
| code | num | 返回值 | 0：成功 |
169
| msg | str | 错误信息 | 默认为 success |
170
| message | str | 错误信息 | 默认为 success |
171
| data | object | 流水 | |
172
173
`data` 对象：
174
175
| 字段 | 类型 | 内容 | 备注 |
176
| ------------- | ----- | -------------- | -------------- |
177
| has_more | num | 是否由下一页 | 1 为是，0 为否 |
178
| total_hamster | num | 总的金仓鼠收益 |
179
| list | array | 礼物列表 |
180
181
`list` 数组：
182
183
| 字段 | 类型 | 内容 | 备注 |
184
| ------------------ | ---------- | ------------------------------------- | -------------------------- |
185
| uid | num | 送礼用户的 uid | |
186
| uname | str | 用户名 | |
187
| time | date / str | 送礼时间 | |
188
| gift_id | num | 礼物 id | |
189
| gift_name | str | 礼物名字 | |
190
| gift_img | str | 礼物图片链接 | |
191
| gift_num | num | 礼物数量 | |
192
| hamster | num | 金仓鼠数量 | |
193
| gold | num | 礼物价值（金瓜子） |
194
| silver | num | 礼物价值（银瓜子） |
195
| ios_hamster | num | 由 iOS 端送出的礼物所收到的金仓鼠 | |
196
| normal_hamster | num | 一般情况下收到的金仓鼠 | |
197
| ios_gold | num | 由 iOS 端送出的礼物所收到的金瓜子数量 | |
198
| normal_gold | num | 一般情况下收到的金瓜子数量 | |
199
| is_hybrid | bool | 是否混合 | 作用不明 |
200
| id | num | 此项 id | 用于翻页 |
201
| is_open_platfrom | num | 是否开放平台 | 作用不明 |
202
| open_platfrom_rate | num | 开放平台比率 (?) | 作用不明 |
203
| receive_title | str | | 作用不明 ，一般为 `"主播"` |
204
| room_id | num | 送礼房间id | 如果礼物为上舰，此项为 `0` |
205
206
<details>
207
<summary>查看响应示例：</summary>
208
209
```json
210
{
211
"code": 0,
212
"message": "0",
213
"ttl": 1,
214
"data": {
215
"list": [
216
{
217
"uid": 0000000000,
218
"uname": "XXXXXXX",
219
"time": "2023-01-01 00:00:00",
220
"gift_id": 31216,
221
"gift_name": "i了i了",
222
"gift_img": "https://s1.hdslb.com/bfs/live/1157a445487b39c0b7368d91b22290c60fa665b2.png",
223
"gift_num": 1,
224
"hamster": 50,
225
"gold": 100,
226
"silver": 0,
227
"ios_hamster": 0,
228
"normal_hamster": 50,
229
"ios_gold": 0,
230
"normal_gold": 100,
231
"is_hybrid": false,
232
"id": 14269551,
233
"is_open_platfrom": 0,
234
"open_platfrom_rate": 0,
235
"receive_title": "主播",
236
"room_id": 000001
237
},
238
{
239
"uid": 0000000000,
240
"uname": "XXXXXXX",
241
"time": "2023-01-01 00:00:00",
242
"gift_id": 10003,
243
"gift_name": "舰长",
244
"gift_img": "https://i0.hdslb.com/bfs/live/f1be2a2d5b227ce72641de1ad64bcc7f9e4111c3.png",
245
"gift_num": 1,
246
"hamster": 69000,
247
"gold": 138000,
248
"silver": 0,
249
"ios_hamster": 0,
250
"normal_hamster": 69000,
251
"ios_gold": 0,
252
"normal_gold": 138000,
253
"is_hybrid": false,
254
"id": 14258453,
255
"is_open_platfrom": 0,
256
"open_platfrom_rate": 0,
257
"receive_title": "主播",
258
"room_id": 000000
259
},
260
{
261
"uid": 0000000000,
262
"uname": "XXXXXXX",
263
"time": "2023-01-01 00:00:00",
264
"gift_id": 31036,
265
"gift_name": "小花花",
266
"gift_img": "https://s1.hdslb.com/bfs/live/8b40d0470890e7d573995383af8a8ae074d485d9.png",
267
"gift_num": 1,
268
"hamster": 50,
269
"gold": 100,
270
"silver": 0,
271
"ios_hamster": 0,
272
"normal_hamster": 50,
273
"ios_gold": 0,
274
"normal_gold": 100,
275
"is_hybrid": false,
276
"id": 14243903,
277
"is_open_platfrom": 0,
278
"open_platfrom_rate": 0,
279
"receive_title": "主播",
280
"room_id": 000001
281
},
282
{
283
"uid": 0000000000,
284
"uname": "XXXXXXX",
285
"time": "2023-01-01 00:00:00",
286
"gift_id": 30047,
287
"gift_name": "友谊的小船",
288
"gift_img": "https://s1.hdslb.com/bfs/live/b33c94c51b669bd88f811ecf5f4e34a1db22a648.png",
289
"gift_num": 1,
290
"hamster": 2450,
291
"gold": 4900,
292
"silver": 0,
293
"ios_hamster": 0,
294
"normal_hamster": 2450,
295
"ios_gold": 0,
296
"normal_gold": 4900,
297
"is_hybrid": false,
298
"id": 14242683,
299
"is_open_platfrom": 0,
300
"open_platfrom_rate": 0,
301
"receive_title": "主播",
302
"room_id": 000001
303
},
304
{
305
"uid": 0000000000,
306
"uname": "XXXXXXX",
307
"time": "2023-01-01 00:00:00",
308
"gift_id": 31738,
309
"gift_name": "粉丝团灯牌",
310
"gift_img": "https://s1.hdslb.com/bfs/live/cbed3bb0a894369b49ceaf0b5337b4491b75ac42.png",
311
"gift_num": 1,
312
"hamster": 0,
313
"gold": 1000,
314
"silver": 1000,
315
"ios_hamster": 0,
316
"normal_hamster": 0,
317
"ios_gold": 0,
318
"normal_gold": 0,
319
"is_hybrid": false,
320
"id": 14237376,
321
"is_open_platfrom": 0,
322
"open_platfrom_rate": 0,
323
"receive_title": "主播",
324
"room_id": 000001
325
}
326
],
327
"has_more": 1,
328
"total_hamster": 122050
329
}
330
}
331
```
332
333
</details>