From 5d35126f812a6b51ec1eb1541b5eea58cbf7799d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=99=A8=E5=8F=B6=E6=A2=A6=E6=98=A5?=
 <65224318+wuziqian211@users.noreply.github.com>
Date: Mon, 5 May 2025 12:31:20 +0800
Subject: [PATCH] feat(message/settings): get auto reply text
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: 晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>
---
 docs/message/settings.md | 111 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 111 insertions(+)

diff --git a/docs/message/settings.md b/docs/message/settings.md
index a76b4a9..f00b10d 100644
--- a/docs/message/settings.md
+++ b/docs/message/settings.md
@@ -173,6 +173,117 @@ curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set' \
 
 </details>
 
+## 获取自动回复文本
+
+> <https://api.vc.bilibili.com/x/im/auto_reply/get_reply_text>
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名   | 类型 | 内容             | 必要性 | 备注                                                                         |
+| -------- | ---- | ---------------- | ------ | ---------------------------------------------------------------------------- |
+| type\[\] | num  | 自动回复类型     | 必要   | 1：被关注回复<br />2：关键词回复<br />3：收到消息回复<br />5：大航海上船回复 |
+| uid      | num  | 自己的mid        | 非必要 |                                                                              |
+| build    | num  | 客户端内部版本号 | 非必要 | 默认为 `0`                                                                   |
+| mobi_app | str  | 平台标识         | 非必要 | 可为 `web` 等                                                                |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容     | 备注                                           |
+| ------- | ---- | -------- | ---------------------------------------------- |
+| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />2：非法参数 |
+| message | str  | 错误信息 | 默认为0                                        |
+| ttl     | num  | 1        |                                                |
+| data    | obj  | 信息本体 |                                                |
+
+`data` 对象：
+
+| 字段  | 类型  | 内容         | 备注                                   |
+| ----- | ----- | ------------ | -------------------------------------- |
+| texts | array | 自动回复文本 | 若未设置此类型自动回复文本，则没有此项 |
+
+`data` 中的 `texts` 数组：
+
+| 项   | 类型 | 内容      | 备注                             |
+| ---- | ---- | --------- | -------------------------------- |
+| 0    | obj  | 文本1     |                                  |
+| n    | obj  | 文本(n+1) | 当类型为 “关键词回复” 时可有多项 |
+| ……   | obj  | ……        | ……                               |
+
+`texts` 数组中的对象：
+
+| 字段  | 类型 | 内容           | 备注                                                                       |
+| ----- | ---- | -------------- | -------------------------------------------------------------------------- |
+| id    | num  | 自动回复规则id |                                                                            |
+| uid   | num  | 自己的mid      |                                                                            |
+| type  | num  | 自动回复类型   | 同请求参数 `type[]`                                                        |
+| title | str  | 规则名称       | 当类型为 “关键词回复” 时有效，否则为空文本                                 |
+| key1  | str  | 精确匹配关键词 | 当类型为 “关键词回复” 时有效，否则为空文本<br />以中文逗号分隔每一个关键词 |
+| key2  | str  | 模糊匹配关键词 | 当类型为 “关键词回复” 时有效，否则为空文本<br />以中文逗号分隔每一个关键词 |
+| reply | str  | 回复内容       |                                                                            |
+
+**示例：**
+
+获取关键词回复规则
+
+```shell
+curl -G 'https://api.vc.bilibili.com/x/im/auto_reply/get_reply_text' \
+  --data-urlencode 'type[]=2' \
+  --data-urlencode 'uid=425503913' \
+  --data-urlencode 'build=0' \
+  --data-urlencode 'mobi_app=web' \
+  -b 'SESSDATA=xxx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "ttl": 1,
+  "data": {
+    "texts": [
+      {
+        "id": 201321,
+        "uid": 425503913,
+        "type": 2,
+        "title": "谢谢",
+        "key1": "谢谢，Thank you",
+        "key2": "感谢",
+        "reply": "我也感谢您对我的支持 (=・ω・=)"
+      },
+      {
+        "id": 201320,
+        "uid": 425503913,
+        "type": 2,
+        "title": "哭2",
+        "key1": "哭",
+        "key2": "",
+        "reply": "我是不会哭的 (=・ω・=)"
+      },
+      {
+        "id": 201318,
+        "uid": 425503913,
+        "type": 2,
+        "title": "哭",
+        "key1": "",
+        "key2": "哭",
+        "reply": "别哭了[tv_微笑]摸摸您 (^・ω・^)"
+      }
+    ]
+  }
+}
+```
+
+</details>
+
 ## 获取系统设置
 
 > <https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting>