This commit is contained in:
晨叶梦春
2025-04-15 22:09:45 +08:00
parent 9fb40928ee
commit 93b4a09aa0
6 changed files with 780 additions and 718 deletions

View File

@@ -1,6 +1,6 @@
# 私信
## 对象说明
## 对象与常量说明
### 会话对象
@@ -60,7 +60,7 @@
| sys_cancel | bool | 是否为系统撤回 | 仅当 `msg_type``5` 且此项值为 `true` 时有此项;若此项值为 `true`,表示目标消息是被系统撤回的,此时前端将不显示该私信且没有提示 |
| notify_code | str | 通知代码 | 发送通知时使用,以下划线 `_` 分割,第 1 项表示主业务 id第 2 项表示子业务 id若这条私信非通知则为空文本详细信息有待补充 |
| new_face_version | num | 表情包版本 | 为 `0` 或无此项表示旧版表情包,此时 B 站会自动转换成新版表情包,例如 `[doge]` -> `[tv_doge]``1` 为新版 |
| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表) |
| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表msg_source) |
`私信主体对象`中的`at_uids`数组:
@@ -70,7 +70,7 @@
| n | num | 用户(n+1) | |
| …… | num | …… | …… |
### 消息来源列表
### 消息来源列表`msg_source`
| 代码 | 含义 | 备注 |
| ---- | ------------------------- | ----------------------------------- |
@@ -86,7 +86,7 @@
| 9 | 自动回复 - 收到消息回复 | B站前端会显示“此条消息为自动回复” |
| 10 | 自动回复 - 关键词回复 | B站前端会显示“此条消息为自动回复” |
| 11 | 自动回复 - 大航海上船回复 | B站前端会显示“此条消息为自动回复” |
| 12 | 自动推送 - UP 主赠言 | 在以前稿件的自动推送与其附带的 UP 主赠言是 2 条不同的私信(其中 UP 主赠言的消息来源代码为 12现在 UP 主赠言已被合并成为稿件自动推送消息的一部分(`attach_msg` |
| 12 | 自动推送 - UP 主赠言 | 在以前稿件推送消息与其附带的 UP 主赠言是 2 条不同的私信(其中 UP 主赠言的消息来源代码为 12现在 UP 主赠言已并入为[稿件自动推送消息](private_msg_content.md#视频推送消息msg_type11)的一部分(`attach_msg` |
| 13 | 粉丝团系统提示 | 如粉丝团中的提示信息“欢迎xxx入群” |
| 16 | 系统 | 目前仅在 `msg_type``51` 时使用该代码 |
| 17 | 互相关注 | 互相关注时自动发送的私信“我们已互相关注,开始聊天吧~” |
@@ -790,7 +790,7 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail'
| text | str | 表情名称 | 包括左右两侧的中括号,如`[tv_doge]` |
| uri | str | 表情链接 | |
| size | num | 表情尺寸 | 1小<br />2大 |
| gif_url | str | 表情GIF链接 | 仅部分表情存在此项 |
| gif_url | str | 表情GIF链接 | 仅部分表情存在此项,如小电视表情 |
**示例:**
@@ -1255,7 +1255,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \
**仅支持发送 `msg[msg_type]` 为 `1`、`2` 或 `5` 的私信**
调用该接口同时会将该会话设置为已读
调用该接口会将该会话设置为已读
**正文参数application/x-www-form-urlencoded**
@@ -1332,7 +1332,7 @@ public class Main {
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-3系统错误<br />-101账号未登录<br />-400请求错误<br />10005msgkey不存在<br />21007消息过长无法发送<br />21020你发送消息频率过快请稍后再发~<br />21026不能给自己发送消息哦~<br />21028由于系统升级暂无法发送敬请谅解<br />21035该类消息暂时无法发送<br />21037图片格式不合法不要调戏接口啦<br />21041消息已超期不能撤回了哦<br />21042消息已经撤回了哦<br />21046你发消息的频率太高了请在24小时后再发吧~<br />21047对方主动回复或关注你前最多发送1条消息~<br />25003因对方隐私设置暂无法给他发送聊天消息<br />25005你已拉黑了对方请先将对方移出黑名单后才能聊天<br />700013已解散QAQ无法执行此操作<br />700014你已不在此同萌中QAQ无法执行此操作 |
| code | num | 返回值 | 0成功<br />-3系统错误<br />-101账号未登录<br />-400请求错误<br />10005msgkey不存在<br />21007消息过长无法发送<br />21015为了维护社区的良好秩序只有绑定手机号的账号才能发送消息<br />21020你发送消息频率过快请稍后再发~<br />21026不能给自己发送消息哦~<br />21028由于系统升级暂无法发送敬请谅解<br />21035该类消息暂时无法发送<br />21037图片格式不合法不要调戏接口啦<br />21041消息已超期不能撤回了哦<br />21042消息已经撤回了哦<br />21046你发消息的频率太高了请在24小时后再发吧~<br />21047对方主动回复或关注你前最多发送1条消息~<br />25003因对方隐私设置暂无法给他发送聊天消息<br />25005你已拉黑了对方请先将对方移出黑名单后才能聊天<br />700013已解散QAQ无法执行此操作<br />700014你已不在此同萌中QAQ无法执行此操作 |
| message | str | 错误信息 | 成功时为0 |
| ttl | num | | 默认为1 |
| data | 有效时obj<br />无效时null | 信息本体 | |