update 【danmaku thumbup list】 APIDoc

docs/danmaku/thumbup.md

@@ -0,0 +1,104 @@
+# 弹幕点赞查询
+
+## 查询指定dmid的点赞数
+
+> https://api.bilibili.com/x/v2/dm/thumbup/stats
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容              | 必要性 | 备注                  |
+| ------ | ---- | ----------------- | ------ | --------------------- |
+| oid    | num  | 视频 cid          | 必要   |                       |
+| ids    | nums | 欲查询的弹幕 dmid | 必要   | 多个 id 之间用`,`分隔 |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容                       | 备注                        |
+| ------- | ---- | -------------------------- | --------------------------- |
+| code    | num  | 返回值                     | 0：成功<br />-400：请求错误 |
+| message | str  | 错误信息                   | 默认为 0                    |
+| ttl     | num  | 1                          |                             |
+| data    | obj  | 弹幕 id 与之对应数据的 Map |                             |
+
+`data`对象：
+
+| 字段        | 类型 | 内容                       | 备注 |
+| ----------- | ---- | -------------------------- | ---- |
+| {弹幕 dmid} | obj  | {弹幕 dmid} 对应的点赞信息 |      |
+
+`{弹幕 dmid}`对象：
+
+| 字段                 | 类型 | 内容                   | 备注                                                    |
+| -------------------- | ---- | ---------------------- | ------------------------------------------------------- |
+| likes                | num  | 对应弹幕所获得的点赞数 |                                                         |
+| user_like            | num  | 当前用户是否点赞       | 0：未点赞<br />1：已点赞<br />需要登录（Cookie 或 APP） |
+| id_str               | str  | 弹幕 dmid 字符串形式   |                                                         |
+| show_threshold       | num  | （？）                 |                                                         |
+| reply_count          | num  | （？）                 |                                                         |
+| gray_release_control | obj  | （？）                 |                                                         |
+
+`gray_release_control`对象：
+
+| 字段          | 类型 | 内容   | 备注 |
+| ------------- | ---- | ------ | ---- |
+| show_dm_reply | bool | （？） |      |
+
+**示例：**
+
+获取视频 BV1AP411d7Qa 1P（cid=1131648710）下的几个弹幕 dmid`1318231376180646144,1318231518484950784,1318231736680887808`
+
+```bash
+curl -G 'https://api.bilibili.com/x/v2/dm/thumbup/stats' \
+	--data-urlencode 'oid=1131648710' \
+	--data-urlencode 'ids=1318231376180646144,1318231518484950784,1318231736680887808' \
+	-b 'SESSDATA=xxx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": {
+        "1318231376180646144": {
+            "likes": 0,
+            "user_like": 0,
+            "id_str": "1318231376180646144",
+            "show_threshold": 10,
+            "reply_count": 0,
+            "gray_release_control": {
+                "show_dm_reply": false
+            }
+        },
+        "1318231518484950784": {
+            "likes": 0,
+            "user_like": 0,
+            "id_str": "1318231518484950784",
+            "show_threshold": 10,
+            "reply_count": 0,
+            "gray_release_control": {
+                "show_dm_reply": false
+            }
+        },
+        "1318231736680887808": {
+            "likes": 0,
+            "user_like": 0,
+            "id_str": "1318231736680887808",
+            "show_threshold": 10,
+            "reply_count": 0,
+            "gray_release_control": {
+                "show_dm_reply": false
+            }
+        }
+    }
+}
+```
+
+</details>