返回提交历史
Modified
message/private_msg.md
+139
-2
XFEstudio/bilibili-API-collect
添加私信消息记录API (#382)
* Update private_msg.md 私信消息记录 * Update private_msg.md
f267684
代码差异
1 个文件
+139
-2
@@ -2,7 +2,7 @@
2
2
3
3
- [未读私信数](#未读私信数)
4
4
- [发送私信（web端）](#发送私信web端)
5
5
- [私信消息记录](#私信消息记录)
6
6
---
7
7
8
8
## 未读私信数
@@ -165,7 +165,7 @@ public class Util{
165
165
166
166
| 字段 | 类型 | 内容 | 备注 |
167
167
| ------------- | ---- | ---------- | ------------ |
168
| msg_key | num | 消息唯一id | |
168
| msg_key| num | 消息唯一id | |
169
169
| msg_content | str | 发送的消息 | |
170
170
| key_hit_infos | obj | | 作用尚不明确 |
171
171
@@ -235,3 +235,140 @@ curl 'http://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
235
235
```
236
236
237
237
</details>
238
239
## 私信消息记录
240
241
> https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs
242
243
*请求方式：GET*
244
245
此接口有设计缺陷，能够获取已经撤回，无法显示（如 发送私信 中msg[msg_type]:3）的消息
246
247
认证方式：Cookie（SESSDATA）
248
249
**url参数：**
250
251
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
252
| ------ | ---- | -------- | ------------ | ------------------ |
253
| sender_device_id | num | 发送者设备 | 可选 | 1 |
254
| talker_id | num | 聊天对象的UID | 必要 | -------------- |
255
| session_type | num | 聊天对象的类型 | 必要 | 1为用户，2为粉丝团 |
256
| size | num | 列出消息条数 | 可选 | 默认是20 |
257
| build | num | 未知 | 可选 | 默认是0 |
258
| mobi_app | str | 设备 | 可选 | web |
259
260
**json回复：**
261
262
根对象：
263
264
| 字段 | 类型 | 内容 | 备注 |
265
| ------- | ------ | -------- | ---------------------------- |
266
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
267
| msg | str | 错误信息 | 默认为0 |
268
| message | str | 错误信息 | 默认为0 |
269
| ttl | num | 1 | |
270
| data | array | 数据列表 | |
271
272
`data`数组：
273
274
| 项 | 类型 | 内容 | 备注 |
275
| ---- | ---- | ------------- | ---- |
276
| messages | array | 聊天记录列表 | |
277
| has_more | num | 0 | |
278
| min_seqno | num | 未知 | |
279
| max_seqno | num | 未知 | |
280
| e_infos | array | 聊天表情列表 | |
281
282
`messages`数组：
283
284
| 项 | 类型 | 内容 | 备注 |
285
| ---- | ---- | ------------- | ---- |
286
| sender_uid | num | 发送者uid | 注意名称是sender_uid |
287
| receiver_type | num | 与session_type对应 | 1为用户，2为粉丝团 |
288
| receiver_id | num | 接收者uid | 注意名称是receiver_id |
289
| msg_type | num | 消息类型 | 1:文字消息<br>2:图片消息<br>5:撤回的消息<br>12、13:通知 |
290
| content | str | 消息内容 | 此处存在设计缺陷 |
291
| msg_seqno | num | 未知 | |
292
| timestamp | num | 消息发送时间戳 | |
293
| at_uids | array | 未知 | |
294
| msg_key | num | 未知 | |
295
| msg_status | num | 消息状态 | 0 |
296
| notify_code |str | 未知 | |
297
| new_face_version |num | 未知 | 疑似只在粉丝团消息中出现 |
298
299
`e_infos`数组：
300
301
| 项 | 类型 | 内容 | 备注 |
302
| ---- | ---- | ------------- | ---- |
303
| text | str | 表情名称 | |
304
| uri | str | 表情链接 | |
305
| size | num | 表情尺寸 | 1 |
306
307
**示例：**
308
309
获取与目标用户`mid=123`私信记录：
310
311
```shell
312
curl 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs?sender_device_id=1&talker_id=123&session_type=1&size=20&build=0&mobi_app=web' \
313
-b 'SESSDATA=xxx'
314
```
315
316
<details>
317
<summary>查看响应示例：</summary>
318
319
```json
320
{
321
"code": 0,
322
"msg": "0",
323
"message": "0",
324
"ttl": 1,
325
"data": {
326
"messages": [
327
{
328
"sender_uid": 2239814,
329
"receiver_type": 1,
330
"receiver_id": 123,
331
"msg_type": 1,
332
"content": "{\"content\":\"[口罩]\"}",
333
"msg_seqno": 309675413389322,
334
"timestamp": 1654154093,
335
"at_uids": [
336
0
337
],
338
"msg_key": 7104537732714964358,
339
"msg_status": 0,
340
"notify_code": "",
341
"new_face_version": 1
342
},
343
{
344
"sender_uid": 2239814,
345
"receiver_type": 1,
346
"receiver_id": 123,
347
"msg_type": 5,
348
"content": "{\"content\":\"1\"}",
349
"msg_seqno": 308302399586307,
350
"timestamp": 1654072255,
351
"at_uids": [
352
0
353
],
354
"msg_key": 7104186240789226795,
355
"msg_status": 0,
356
"notify_code": ""
357
},
358
],
359
"has_more": 0,
360
"min_seqno": 308188515844097,
361
"max_seqno": 309675413389322,
362
"e_infos": [
363
{
364
"text": "[口罩]",
365
"url": "http://i0.hdslb.com/bfs/emote/3ad2f66b151496d2a5fb0a8ea75f32265d778dd3.png",
366
"size": 1
367
}
368
]
369
}
370
}
371
```
372
373
</details>
374