diff --git a/message/private_msg.md b/message/private_msg.md index 11d69d2..006c8dd 100644 --- a/message/private_msg.md +++ b/message/private_msg.md @@ -2,7 +2,7 @@ - [未读私信数](#未读私信数) - [发送私信(web端)](#发送私信web端) - +- [私信消息记录](#私信消息记录) --- ## 未读私信数 @@ -165,7 +165,7 @@ public class Util{ | 字段 | 类型 | 内容 | 备注 | | ------------- | ---- | ---------- | ------------ | -| msg_key | num | 消息唯一id | | +| msg_key| num | 消息唯一id | | | msg_content | str | 发送的消息 | | | key_hit_infos | obj | | 作用尚不明确 | @@ -235,3 +235,140 @@ curl 'http://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \ ``` + +## 私信消息记录 + +> https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs + +*请求方式:GET* + +此接口有设计缺陷,能够获取已经撤回,无法显示(如 发送私信 中msg[msg_type]:3)的消息 + +认证方式:Cookie(SESSDATA) + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ------------ | ------------------ | +| sender_device_id | num | 发送者设备 | 可选 | 1 | +| talker_id | num | 聊天对象的UID | 必要 | -------------- | +| session_type | num | 聊天对象的类型 | 必要 | 1为用户,2为粉丝团 | +| size | num | 列出消息条数 | 可选 | 默认是20 | +| build | num | 未知 | 可选 | 默认是0 | +| mobi_app | str | 设备 | 可选 | web | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ---------------------------- | +| code | num | 返回值 | 0:成功
-400:请求错误 | +| msg | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 数据列表 | | + +`data`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---- | +| messages | array | 聊天记录列表 | | +| has_more | num | 0 | | +| min_seqno | num | 未知 | | +| max_seqno | num | 未知 | | +| e_infos | array | 聊天表情列表 | | + +`messages`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---- | +| sender_uid | num | 发送者uid | 注意名称是sender_uid | +| receiver_type | num | 与session_type对应 | 1为用户,2为粉丝团 | +| receiver_id | num | 接收者uid | 注意名称是receiver_id | +| msg_type | num | 消息类型 | 1:文字消息
2:图片消息
5:撤回的消息
12、13:通知 | +| content | str | 消息内容 | 此处存在设计缺陷 | +| msg_seqno | num | 未知 | | +| timestamp | num | 消息发送时间戳 | | +| at_uids | array | 未知 | | +| msg_key | num | 未知 | | +| msg_status | num | 消息状态 | 0 | +| notify_code |str | 未知 | | +| new_face_version |num | 未知 | 疑似只在粉丝团消息中出现 | + +`e_infos`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---- | +| text | str | 表情名称 | | +| uri | str | 表情链接 | | +| size | num | 表情尺寸 | 1 | + +**示例:** + +获取与目标用户`mid=123`私信记录: + +```shell +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' \ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code": 0, + "msg": "0", + "message": "0", + "ttl": 1, + "data": { + "messages": [ + { + "sender_uid": 2239814, + "receiver_type": 1, + "receiver_id": 123, + "msg_type": 1, + "content": "{\"content\":\"[口罩]\"}", + "msg_seqno": 309675413389322, + "timestamp": 1654154093, + "at_uids": [ + 0 + ], + "msg_key": 7104537732714964358, + "msg_status": 0, + "notify_code": "", + "new_face_version": 1 + }, + { + "sender_uid": 2239814, + "receiver_type": 1, + "receiver_id": 123, + "msg_type": 5, + "content": "{\"content\":\"1\"}", + "msg_seqno": 308302399586307, + "timestamp": 1654072255, + "at_uids": [ + 0 + ], + "msg_key": 7104186240789226795, + "msg_status": 0, + "notify_code": "" + }, + ], + "has_more": 0, + "min_seqno": 308188515844097, + "max_seqno": 309675413389322, + "e_infos": [ + { + "text": "[口罩]", + "url": "http://i0.hdslb.com/bfs/emote/3ad2f66b151496d2a5fb0a8ea75f32265d778dd3.png", + "size": 1 + } + ] + } +} +``` + +
+