This commit is contained in:
wuziqian211 2024-03-28 23:21:30 +08:00
parent b8da0e5b18
commit f1c53f92f4
3 changed files with 64 additions and 30 deletions

View File

@ -8,6 +8,8 @@
认证方式CookieSESSDATA
本接口不会返回未读的私信数,要获取未读的私信数请查看[未读私信数](private_msg.md#未读私信数)相关说明
**json回复**
根对象:

View File

@ -1,6 +1,10 @@
# 私信消息类型、内容说明
## 文字消息(`msg_type=1`
## 通用消息类型
以下消息类型适用于大多数会话
### 文字消息(`msg_type=1`
在发送私信时,请确保下面的对象合法且 `content` 项的值为非空文本,否则会提示 `请求错误`
@ -20,7 +24,7 @@
}
```
## 图片消息(`msg_type=2`
### 图片消息(`msg_type=2`
在发送私信时,请确保下面的对象合法且 `url` 项的值为 B 站的图床 url否则会报 21037 `图片格式不合法,不要调戏接口啦` 错误
@ -50,11 +54,11 @@
}
```
## 撤回消息(`msg_type=5`
### 撤回消息(`msg_type=5`
内容为目标私信的 `msg_key`
请确保目标私信存在、在撤回有效期里,且与发送的私信在同一会话内;成功发送此私信后,目标私信的 `msg_status` 会变成 `1`
请确保目标私信存在、在撤回有效期120 秒)里,且与发送的私信在同一会话内;成功发送此私信后,目标私信的 `msg_status` 会变成 `1`
**示例:**
@ -68,7 +72,7 @@
## 自定义表情消息(`msg_type=6`
对象结构基本 [图片消息](#图片消息msg_type2)
结构同[图片消息](#图片消息msg_type2)
## 分享消息(`msg_type=7`
@ -100,11 +104,37 @@
}
```
## 小程序消息(`msg_type=9`
### 小程序消息(`msg_type=9`
待补充
根对象:
## 通知消息(`msg_type=10`
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ------------------------- |
| avatar | str | 小程序图标 | |
| cover | str | 小程序封面 | |
| id | str | 小程序id | |
| jump_uri | str | 小程序链接 | |
| label_cover | str | 标签图标 | |
| label_name | str | 标签文字内容 | |
| name | str | 小程序名称 | |
| title | str | 小程序标题 | |
**示例:**
```json
{
"avatar": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png",
"cover": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png",
"id": "bili91e3e7e93af281f9",
"jump_uri": "https://mall.bilibili.com/miniapp/bili91e3e7e93af281f9/pages/main?___timestamp=1689526821040&_biliFrom=about_bili_message&share_medium=android&share_source=bili_message&bbid=XU8CE838022AF6625C64B2153A3EF1E571AFF&ts=1689526821048",
"label_cover": "https://i0.hdslb.com/bfs/mall/mall/ae/0e/ae0ee4a857df5e307e1d04b5d420cb5b.png",
"label_name": "小程序",
"name": "主站测试专用小程序",
"title": "主站测试专用小程序"
}
```
### 通知消息(`msg_type=10`
此类型消息仅可接收,不可直接发送
@ -172,9 +202,9 @@
}
```
## 视频推送消息(`msg_type=11`
### 视频推送消息(`msg_type=11`
此类型消息仅可接收,不可直接发送
此类型消息仅可接收,不可直接发送;有小概率会出现即使视频存在,也只会出现 `rid`、`type` 和 `attach_msg` 三项的现象
根对象:
@ -210,9 +240,9 @@
}
```
## 专栏推送消息(`msg_type=12`
### 专栏推送消息(`msg_type=12`
此类型消息仅可接收,不可直接发送
此类型消息仅可接收,不可直接发送;有小概率会出现即使专栏存在,也只会出现 `rid`、`type` 和 `attach_msg` 三项的现象
根对象:
@ -251,7 +281,7 @@
```
## 图片卡片消息(`msg_type=13`
### 图片卡片消息(`msg_type=13`
此类型消息仅可接收,不可直接发送
@ -273,7 +303,7 @@
}
```
## 被关注时的自动推送消息(`msg_type=16`
### 被关注时的自动推送消息(`msg_type=16`
**示例:**
@ -318,7 +348,7 @@
}
```
## 系统提示消息(`msg_type=18`
### 系统提示消息(`msg_type=18`
此类型消息仅可接收,不可直接发送
@ -351,3 +381,9 @@
"content": "[{\"text\":\"对方主动回复或关注你前最多发送1条消息\",\"color_day\":\"#9499A0\",\"color_nig\":\"#9499A0\"}]"
}
```
## 粉丝团消息类型
以下消息类型仅常见于粉丝团中的系统消息(`receiver_type` 为 `2``sender_uid``0`

View File

@ -943,8 +943,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------- | ------ | --------------------------------- |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------- | ------ | ------------------- |
| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 |
**json回复**
@ -954,8 +954,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误 |
| msg | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | 信息本体 | 用户信息随机排序 |
`data`数组:
@ -972,7 +972,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
| ------- | ---- | ------------ | -------------------- |
| mid | num | mid | |
| name | str | 昵称 | |
| sex | str | 性别 | 男/女/保密 |
| face | str | 头像链接 | |
| sign | str | 签名 | |
| rank | num | 用户权限等级 | |
@ -995,34 +994,31 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
```json
{
"code": 0,
"msg": "",
"message": "",
"ttl": 1,
"data": [{
"mid": 1,
"name": "bishi",
"sex": "男",
"face": "https://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"sign": "",
"rank": 10000,
"level": 4,
"level": 6,
"silence": 0
}, {
"mid": 2,
"name": "碧诗",
"sex": "男",
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
"rank": 20000,
"level": 6,
"silence": 0
}, {
"mid": 3,
"name": "囧囧倉",
"sex": "男",
"face": "https://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
"rank": 10000,
"level": 5,
"level": 6,
"silence": 0
}]
}