104 lines
2.7 KiB
Markdown
104 lines
2.7 KiB
Markdown
# 私信消息类型、内容说明
|
||
|
||
## 文字消息（`msg_type=1`）
|
||
|
||
在发送私信时，请确保下面的对象合法且 `content` 项的值为非 0 长度的文本，否则会提示 `请求错误`
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ---- |
|
||
| content | str | 私信内容 | |
|
||
|
||
**示例：**
|
||
|
||
内容为 `Hello` 的文字消息
|
||
|
||
```json
|
||
{
|
||
"content": "Hello"
|
||
}
|
||
```
|
||
|
||
## 图片消息（`msg_type=2`）
|
||
|
||
在发送私信时，请确保下面的对象合法且 `url` 项的值为 B 站的图床 url，否则会报 21037 `图片格式不合法，不要调戏接口啦` 错误
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ---- | ---------- | ------------------------- |
|
||
| url | str | 图片url | 一般为B站图床url |
|
||
| height | num | 图片高度 | 单位：像素（非必要） |
|
||
| width | num | 图片宽度 | 单位：像素（非必要） |
|
||
| type | str | 图片格式 | （非必要） |
|
||
| original | num | 是否为原图 | 当本参数值为`1`时，APP上会出现“下载原图”按钮（非必要） |
|
||
| size | num | 文件大小 | 单位：千字节（非必要） |
|
||
|
||
**示例：**
|
||
|
||
图片 `https://message.biliimg.com/bfs/im_new/c161fdf51d901c1607a15e30f10116dd425503913.jpg`
|
||
|
||
```json
|
||
{
|
||
"url": "https://message.biliimg.com/bfs/im_new/c161fdf51d901c1607a15e30f10116dd425503913.jpg",
|
||
"height": 300,
|
||
"width": 300,
|
||
"imageType": "jpeg",
|
||
"original": 1,
|
||
"size": 55.443
|
||
}
|
||
```
|
||
|
||
## 撤回消息（`msg_type=5`）
|
||
|
||
内容为目标私信的 `msg_key`
|
||
|
||
请确保目标私信存在，且发送的私信与目标私信在同一会话内；发送此私信后，目标私信的 `msg_status` 会变成 `1`
|
||
|
||
**示例：**
|
||
|
||
假如存在 `msg_key` 为 `7345551441311046575` 的私信 A，用户发送了 `msg_type` 为 `5` 且 `content` 为以下内容的私信 B：
|
||
|
||
```json
|
||
7345551441311046575
|
||
```
|
||
|
||
这时，私信 A 就会被撤回，并且其 `msg_status` 也会变成 `1`
|
||
|
||
## 自定义表情消息（`msg_type=6`）
|
||
|
||
对象结构基本同 [图片消息](#图片消息（`msg_type=6`）)
|
||
|
||
## 分享消息（`msg_type=7`）
|
||
|
||
## 小程序消息（`msg_type=9`）
|
||
|
||
待补充
|
||
|
||
## 通知消息（`msg_type=10`）
|
||
|
||
本类型消息仅可接收，不能直接发送
|
||
|
||
|
||
## 视频推送消息（`msg_type=11`）
|
||
|
||
本类型消息仅可接收，不能直接发送
|
||
|
||
|
||
## 专栏推送消息（`msg_type=12`）
|
||
|
||
本类型消息仅可接收，不能直接发送
|
||
|
||
|
||
## 图片卡片消息（`msg_type=13`）
|
||
|
||
本类型消息仅可接收，不能直接发送
|
||
|
||
|
||
## 被关注时的自动推送消息（`msg_type=16`）
|
||
|
||
## 系统提示消息（`msg_type=18`）
|
||
|
||
本类型消息仅可接收，不能直接发送
|