update
This commit is contained in:
parent
b8da0e5b18
commit
f1c53f92f4
@ -8,6 +8,8 @@
|
||||
|
||||
认证方式:Cookie(SESSDATA)
|
||||
|
||||
本接口不会返回未读的私信数,要获取未读的私信数请查看[未读私信数](private_msg.md#未读私信数)相关说明
|
||||
|
||||
**json回复:**
|
||||
|
||||
根对象:
|
||||
|
||||
@ -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`)
|
||||
|
||||
|
||||
|
||||
@ -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
|
||||
}]
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user