返回提交历史
Modified
docs/message/settings.md
+111
-0
XFEstudio/bilibili-API-collect
feat(message/settings): get auto reply text
Signed-off-by: 晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>
5d35126
代码差异
1 个文件
+111
-0
@@ -173,6 +173,117 @@ curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set' \
173
173
174
174
</details>
175
175
176
## 获取自动回复文本
177
178
> <https://api.vc.bilibili.com/x/im/auto_reply/get_reply_text>
179
180
*请求方式：GET*
181
182
认证方式：Cookie（SESSDATA）
183
184
**url参数：**
185
186
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
187
| -------- | ---- | ---------------- | ------ | ---------------------------------------------------------------------------- |
188
| type\[\] | num | 自动回复类型 | 必要 | 1：被关注回复<br />2：关键词回复<br />3：收到消息回复<br />5：大航海上船回复 |
189
| uid | num | 自己的mid | 非必要 | |
190
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
191
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
192
193
**json回复：**
194
195
根对象：
196
197
| 字段 | 类型 | 内容 | 备注 |
198
| ------- | ---- | -------- | ---------------------------------------------- |
199
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />2：非法参数 |
200
| message | str | 错误信息 | 默认为0 |
201
| ttl | num | 1 | |
202
| data | obj | 信息本体 | |
203
204
`data` 对象：
205
206
| 字段 | 类型 | 内容 | 备注 |
207
| ----- | ----- | ------------ | -------------------------------------- |
208
| texts | array | 自动回复文本 | 若未设置此类型自动回复文本，则没有此项 |
209
210
`data` 中的 `texts` 数组：
211
212
| 项 | 类型 | 内容 | 备注 |
213
| ---- | ---- | --------- | -------------------------------- |
214
| 0 | obj | 文本1 | |
215
| n | obj | 文本(n+1) | 当类型为 “关键词回复” 时可有多项 |
216
| …… | obj | …… | …… |
217
218
`texts` 数组中的对象：
219
220
| 字段 | 类型 | 内容 | 备注 |
221
| ----- | ---- | -------------- | -------------------------------------------------------------------------- |
222
| id | num | 自动回复规则id | |
223
| uid | num | 自己的mid | |
224
| type | num | 自动回复类型 | 同请求参数 `type[]` |
225
| title | str | 规则名称 | 当类型为 “关键词回复” 时有效，否则为空文本 |
226
| key1 | str | 精确匹配关键词 | 当类型为 “关键词回复” 时有效，否则为空文本<br />以中文逗号分隔每一个关键词 |
227
| key2 | str | 模糊匹配关键词 | 当类型为 “关键词回复” 时有效，否则为空文本<br />以中文逗号分隔每一个关键词 |
228
| reply | str | 回复内容 | |
229
230
**示例：**
231
232
获取关键词回复规则
233
234
```shell
235
curl -G 'https://api.vc.bilibili.com/x/im/auto_reply/get_reply_text' \
236
--data-urlencode 'type[]=2' \
237
--data-urlencode 'uid=425503913' \
238
--data-urlencode 'build=0' \
239
--data-urlencode 'mobi_app=web' \
240
-b 'SESSDATA=xxx'
241
```
242
243
<details>
244
<summary>查看响应示例：</summary>
245
246
```json
247
{
248
"code": 0,
249
"message": "0",
250
"ttl": 1,
251
"data": {
252
"texts": [
253
{
254
"id": 201321,
255
"uid": 425503913,
256
"type": 2,
257
"title": "谢谢",
258
"key1": "谢谢，Thank you",
259
"key2": "感谢",
260
"reply": "我也感谢您对我的支持 (=・ω・=)"
261
},
262
{
263
"id": 201320,
264
"uid": 425503913,
265
"type": 2,
266
"title": "哭2",
267
"key1": "哭",
268
"key2": "",
269
"reply": "我是不会哭的 (=・ω・=)"
270
},
271
{
272
"id": 201318,
273
"uid": 425503913,
274
"type": 2,
275
"title": "哭",
276
"key1": "",
277
"key2": "哭",
278
"reply": "别哭了[tv_微笑]摸摸您 (^・ω・^)"
279
}
280
]
281
}
282
}
283
```
284
285
</details>
286
176
287
## 获取系统设置
177
288
178
289
> <https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting>