feat(message/settings): get auto reply text

Signed-off-by: 晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>
This commit is contained in:
晨叶梦春 2025-05-05 12:31:20 +08:00
parent e07ef4cbde
commit 5d35126f81
No known key found for this signature in database
GPG Key ID: FE72DF87FB90F5E7

View File

@ -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*
认证方式CookieSESSDATA
**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>