SocialSisterYi · sakurayang · Jan 6, 2023
diff --git a/README.md b/README.md
@@ -193,6 +193,7 @@ PS：所有 rest api 均可使用 https，文档中为了统一写作`http` (除
   - [ ] 直播间操作
   - [ ] [直播视频流](live/live_stream.md)
   - [ ] [直播信息流](live/message_stream.md)
+  - [ ] [直播流水](live/live_bill.md)
 - [ ] [转正答题](newbie_exam)
   - [x] [查询信息](newbie_exam/info.md)
   - [x] [拉取题目](newbie_exam/fetch.md)

diff --git a/live/live_bill.md b/live/live_bill.md
@@ -0,0 +1,333 @@
+# 直播流水
+
+- [获取所有礼物列表](#获取所有礼物列表)
+- [获取流水](#获取流水)
+
+## 获取所有礼物列表
+
+> https://api.live.bilibili.com/gift/v1/master/getGiftTypes
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型  | 内容     | 备注           |
+| ------- | ----- | -------- | -------------- |
+| code    | num   | 返回值   | 0：成功        |
+| msg     | str   | 错误信息 | 默认为 success |
+| message | str   | 错误信息 | 默认为 success |
+| data    | array | 礼物列表 |                |
+
+`data` 数组：
+
+| 字段      | 类型 | 内容     | 备注                                                                           |
+| --------- | ---- | -------- | ------------------------------------------------------------------------------ |
+| gift_id   | num  | 礼物 id  |                                                                                |
+| gift_name | str  | 礼物名称 |                                                                                |
+| price     | num  | 瓜子数量 | 电池礼物为金瓜子数量，银瓜子礼物为银瓜子数量。 （金瓜子数量 / 100 = 电池数量） |
+
+*注：特殊礼物如舰长、提督、总督等没有 `price` 字段*
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+  {
+    "code": 0,
+    "msg": "success",
+    "message": "success",
+    "data": [
+      {
+        "gift_id": 10001,
+        "gift_name": "总督"
+      },
+      {
+        "gift_id": 10002,
+        "gift_name": "提督"
+      },
+      {
+        "gift_id": 10003,
+        "gift_name": "舰长"
+      },
+      {
+        "gift_id": 12000,
+        "gift_name": "醒目留言"
+      },
+      {
+        "gift_id": 1,
+        "price": 100,
+        "gift_name": "辣条"
+      },
+      {
+        "gift_id": 3,
+        "price": 9900,
+        "gift_name": "B坷垃"
+      },
+      {
+        "gift_id": 6,
+        "price": 1000,
+        "gift_name": "亿圆"
+      },
+      {
+        "gift_id": 30426,
+        "price": 0,
+        "gift_name": "BLS能量石"
+      },
+      {
+        "gift_id": 30706,
+        "price": 1000,
+        "gift_name": "生日快乐"
+      },
+      {
+        "gift_id": 30707,
+        "price": 5200,
+        "gift_name": "生日蛋糕"
+      },
+      {
+        "gift_id": 30708,
+        "price": 52000,
+        "gift_name": "生日王冠"
+      },
+      {
+        "gift_id": 31049,
+        "price": 6600,
+        "gift_name": "干杯"
+      },
+      {
+        "gift_id": 31116,
+        "price": 6600,
+        "gift_name": "干杯"
+      },
+      {
+        "gift_id": 31251,
+        "price": 6600,
+        "gift_name": "干杯"
+      },
+      {
+        "gift_id": 31531,
+        "price": 0,
+        "gift_name": "PK票"
+      },
+      {
+        "gift_id": 31588,
+        "price": 19900,
+        "gift_name": "星河入梦"
+      },
+      {
+        "gift_id": 31589,
+        "price": 131400,
+        "gift_name": "我星永恒"
+      },
+      {
+        "gift_id": 32276,
+        "price": 0,
+        "gift_name": "粉丝团灯牌"
+      },
+      ...
+    ]
+  }
+```
+
+</details>
+
+---
+
+## 获取流水
+
+> https://api.live.bilibili.com/xlive/revenue/v1/giftStream/getReceivedGiftStreamNextList
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+请求参数：
+
+| 参数名     | 类型          | 内容                    | 必要性     | 备注                                   |
+| ---------- | ------------- | ----------------------- | ---------- |
+| limit      | num           | 一页有多少条目          | 必要       |                                        |
+| coin_type  | num           | 礼物类型                | 必要       | 0 为所有，1 为电池礼物，2 为银瓜子礼物 |
+| begin_time | date / string | 流水的日期              | 必要       | 格式为 yyyy-MM-dd                      |
+| uname      | string        | 筛选的用户名            | 非必要     |                                        |
+| last_id    | num           | 上一页页末的礼物列表 id | 翻页时必要 | 见下方 `list` 数组说明                 |
+| gift_id    | num           | 筛选的礼物 id           |            |
+
+请求示例：`https://api.live.bilibili.com/xlive/revenue/v1/giftStream/getReceivedGiftStreamNextList?limit=20&coin_type=0&begin_time=2023-01-01`
+
+请求示例（翻页时）：`https://api.live.bilibili.com/xlive/revenue/v1/giftStream/getReceivedGiftStreamNextList?last_id=13834493&limit=20&coin_type=0&begin_time=2023-01-01`
+
+**json 回复：**
+
+根对象：
+
+| 字段    | 类型   | 内容     | 备注           |
+| ------- | ------ | -------- | -------------- |
+| code    | num    | 返回值   | 0：成功        |
+| msg     | str    | 错误信息 | 默认为 success |
+| message | str    | 错误信息 | 默认为 success |
+| data    | object | 流水     |                |
+
+`data` 对象：
+
+| 字段          | 类型  | 内容           | 备注           |
+| ------------- | ----- | -------------- | -------------- |
+| has_more      | num   | 是否由下一页   | 1 为是，0 为否 |
+| total_hamster | num   | 总的金仓鼠收益 |
+| list          | array | 礼物列表       |
+
+`list` 数组：
+
+| 字段               | 类型       | 内容                                  | 备注                       |
+| ------------------ | ---------- | ------------------------------------- | -------------------------- |
+| uid                | num        | 送礼用户的 uid                        |                            |
+| uname              | str        | 用户名                                |                            |
+| time               | date / str | 送礼时间                              |                            |
+| gift_id            | num        | 礼物 id                               |                            |
+| gift_name          | str        | 礼物名字                              |                            |
+| gift_img           | str        | 礼物图片链接                          |                            |
+| gift_num           | num        | 礼物数量                              |                            |
+| hamster            | num        | 金仓鼠数量                            |                            |
+| gold               | num        | 礼物价值（金瓜子）                    |
+| silver             | num        | 礼物价值（银瓜子）                    |
+| ios_hamster        | num        | 由 iOS 端送出的礼物所收到的金仓鼠     |                            |
+| normal_hamster     | num        | 一般情况下收到的金仓鼠                |                            |
+| ios_gold           | num        | 由 iOS 端送出的礼物所收到的金瓜子数量 |                            |
+| normal_gold        | num        | 一般情况下收到的金瓜子数量            |                            |
+| is_hybrid          | bool       | 是否混合                              | 作用不明                   |
+| id                 | num        | 此项 id                               | 用于翻页                   |
+| is_open_platfrom   | num        | 是否开放平台                          | 作用不明                   |
+| open_platfrom_rate | num        | 开放平台比率 (?)                      | 作用不明                   |
+| receive_title      | str        |                                       | 作用不明 ，一般为 `"主播"` |
+| room_id            | num        | 送礼房间id                            | 如果礼物为上舰，此项为 `0` |
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "ttl": 1,
+  "data": {
+    "list": [
+      {
+        "uid": 0000000000,
+        "uname": "XXXXXXX",
+        "time": "2023-01-01 00:00:00",
+        "gift_id": 31216,
+        "gift_name": "i了i了",
+        "gift_img": "https://s1.hdslb.com/bfs/live/1157a445487b39c0b7368d91b22290c60fa665b2.png",
+        "gift_num": 1,
+        "hamster": 50,
+        "gold": 100,
+        "silver": 0,
+        "ios_hamster": 0,
+        "normal_hamster": 50,
+        "ios_gold": 0,
+        "normal_gold": 100,
+        "is_hybrid": false,
+        "id": 14269551,
+        "is_open_platfrom": 0,
+        "open_platfrom_rate": 0,
+        "receive_title": "主播",
+        "room_id": 000001
+      },
+      {
+        "uid": 0000000000,
+        "uname": "XXXXXXX",
+        "time": "2023-01-01 00:00:00",
+        "gift_id": 10003,
+        "gift_name": "舰长",
+        "gift_img": "https://i0.hdslb.com/bfs/live/f1be2a2d5b227ce72641de1ad64bcc7f9e4111c3.png",
+        "gift_num": 1,
+        "hamster": 69000,
+        "gold": 138000,
+        "silver": 0,
+        "ios_hamster": 0,
+        "normal_hamster": 69000,
+        "ios_gold": 0,
+        "normal_gold": 138000,
+        "is_hybrid": false,
+        "id": 14258453,
+        "is_open_platfrom": 0,
+        "open_platfrom_rate": 0,
+        "receive_title": "主播",
+        "room_id": 000000
+      },
+      {
+        "uid": 0000000000,
+        "uname": "XXXXXXX",
+        "time": "2023-01-01 00:00:00",
+        "gift_id": 31036,
+        "gift_name": "小花花",
+        "gift_img": "https://s1.hdslb.com/bfs/live/8b40d0470890e7d573995383af8a8ae074d485d9.png",
+        "gift_num": 1,
+        "hamster": 50,
+        "gold": 100,
+        "silver": 0,
+        "ios_hamster": 0,
+        "normal_hamster": 50,
+        "ios_gold": 0,
+        "normal_gold": 100,
+        "is_hybrid": false,
+        "id": 14243903,
+        "is_open_platfrom": 0,
+        "open_platfrom_rate": 0,
+        "receive_title": "主播",
+        "room_id": 000001
+      },
+      {
+        "uid": 0000000000,
+        "uname": "XXXXXXX",
+        "time": "2023-01-01 00:00:00",
+        "gift_id": 30047,
+        "gift_name": "友谊的小船",
+        "gift_img": "https://s1.hdslb.com/bfs/live/b33c94c51b669bd88f811ecf5f4e34a1db22a648.png",
+        "gift_num": 1,
+        "hamster": 2450,
+        "gold": 4900,
+        "silver": 0,
+        "ios_hamster": 0,
+        "normal_hamster": 2450,
+        "ios_gold": 0,
+        "normal_gold": 4900,
+        "is_hybrid": false,
+        "id": 14242683,
+        "is_open_platfrom": 0,
+        "open_platfrom_rate": 0,
+        "receive_title": "主播",
+        "room_id": 000001
+      },
+      {
+        "uid": 0000000000,
+        "uname": "XXXXXXX",
+        "time": "2023-01-01 00:00:00",
+        "gift_id": 31738,
+        "gift_name": "粉丝团灯牌",
+        "gift_img": "https://s1.hdslb.com/bfs/live/cbed3bb0a894369b49ceaf0b5337b4491b75ac42.png",
+        "gift_num": 1,
+        "hamster": 0,
+        "gold": 1000,
+        "silver": 1000,
+        "ios_hamster": 0,
+        "normal_hamster": 0,
+        "ios_gold": 0,
+        "normal_gold": 0,
+        "is_hybrid": false,
+        "id": 14237376,
+        "is_open_platfrom": 0,
+        "open_platfrom_rate": 0,
+        "receive_title": "主播",
+        "room_id": 000001
+      }
+    ],
+    "has_more": 1,
+    "total_hamster": 122050
+  }
+}
+```
+
+</details>