返回提交历史
Modified
docs/message/msg.md
+2
-0
Modified
docs/message/private_msg_content.md
+51
-15
Modified
docs/user/info.md
+11
-15
XFEstudio/bilibili-API-collect
update
f1c53f9
代码差异
3 个文件
+64
-30
@@ -8,6 +8,8 @@
8
8
9
9
认证方式：Cookie（SESSDATA）
10
10
11
本接口不会返回未读的私信数，要获取未读的私信数请查看[未读私信数](private_msg.md#未读私信数)相关说明
12
11
13
**json回复：**
12
14
13
15
根对象：
@@ -1,6 +1,10 @@
1
1
# 私信消息类型、内容说明
2
2
3
## 文字消息（`msg_type=1`）
3
## 通用消息类型
4
5
以下消息类型适用于大多数会话
6
7
### 文字消息（`msg_type=1`）
4
8
5
9
在发送私信时，请确保下面的对象合法且 `content` 项的值为非空文本，否则会提示 `请求错误`
6
10
@@ -20,7 +24,7 @@
20
24
}
21
25
```
22
26
23
## 图片消息（`msg_type=2`）
27
### 图片消息（`msg_type=2`）
24
28
25
29
在发送私信时，请确保下面的对象合法且 `url` 项的值为 B 站的图床 url，否则会报 21037 `图片格式不合法，不要调戏接口啦` 错误
26
30
@@ -50,11 +54,11 @@
50
54
}
51
55
```
52
56
53
## 撤回消息（`msg_type=5`）
57
### 撤回消息（`msg_type=5`）
54
58
55
59
内容为目标私信的 `msg_key`
56
60
57
请确保目标私信存在、在撤回有效期里，且与发送的私信在同一会话内；成功发送此私信后，目标私信的 `msg_status` 会变成 `1`
61
请确保目标私信存在、在撤回有效期（120 秒）里，且与发送的私信在同一会话内；成功发送此私信后，目标私信的 `msg_status` 会变成 `1`
58
62
59
63
**示例：**
60
64
@@ -68,7 +72,7 @@
68
72
69
73
## 自定义表情消息（`msg_type=6`）
70
74
71
对象结构基本同 [图片消息](#图片消息msg_type2)
75
结构同[图片消息](#图片消息msg_type2)
72
76
73
77
## 分享消息（`msg_type=7`）
74
78
@@ -100,11 +104,37 @@
100
104
}
101
105
```
102
106
103
## 小程序消息（`msg_type=9`）
107
### 小程序消息（`msg_type=9`）
104
108
105
待补充
109
根对象：
106
110
107
## 通知消息（`msg_type=10`）
111
| 字段 | 类型 | 内容 | 备注 |
112
| ----------- | ---- | ------------ | ------------------------- |
113
| avatar | str | 小程序图标 | |
114
| cover | str | 小程序封面 | |
115
| id | str | 小程序id | |
116
| jump_uri | str | 小程序链接 | |
117
| label_cover | str | 标签图标 | |
118
| label_name | str | 标签文字内容 | |
119
| name | str | 小程序名称 | |
120
| title | str | 小程序标题 | |
121
122
**示例：**
123
124
```json
125
{
126
"avatar": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png",
127
"cover": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png",
128
"id": "bili91e3e7e93af281f9",
129
"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",
130
"label_cover": "https://i0.hdslb.com/bfs/mall/mall/ae/0e/ae0ee4a857df5e307e1d04b5d420cb5b.png",
131
"label_name": "小程序",
132
"name": "主站测试专用小程序",
133
"title": "主站测试专用小程序"
134
}
135
```
136
137
### 通知消息（`msg_type=10`）
108
138
109
139
此类型消息仅可接收，不可直接发送
110
140
@@ -172,9 +202,9 @@
172
202
}
173
203
```
174
204
175
## 视频推送消息（`msg_type=11`）
205
### 视频推送消息（`msg_type=11`）
176
206
177
此类型消息仅可接收，不可直接发送
207
此类型消息仅可接收，不可直接发送；有小概率会出现即使视频存在，也只会出现 `rid`、`type` 和 `attach_msg` 三项的现象
178
208
179
209
根对象：
180
210
@@ -210,9 +240,9 @@
210
240
}
211
241
```
212
242
213
## 专栏推送消息（`msg_type=12`）
243
### 专栏推送消息（`msg_type=12`）
214
244
215
此类型消息仅可接收，不可直接发送
245
此类型消息仅可接收，不可直接发送；有小概率会出现即使专栏存在，也只会出现 `rid`、`type` 和 `attach_msg` 三项的现象
216
246
217
247
根对象：
218
248
@@ -251,7 +281,7 @@
251
281
```
252
282
253
283
254
## 图片卡片消息（`msg_type=13`）
284
### 图片卡片消息（`msg_type=13`）
255
285
256
286
此类型消息仅可接收，不可直接发送
257
287
@@ -273,7 +303,7 @@
273
303
}
274
304
```
275
305
276
## 被关注时的自动推送消息（`msg_type=16`）
306
### 被关注时的自动推送消息（`msg_type=16`）
277
307
278
308
**示例：**
279
309
@@ -318,7 +348,7 @@
318
348
}
319
349
```
320
350
321
## 系统提示消息（`msg_type=18`）
351
### 系统提示消息（`msg_type=18`）
322
352
323
353
此类型消息仅可接收，不可直接发送
324
354
@@ -351,3 +381,9 @@
351
381
"content": "[{\"text\":\"对方主动回复或关注你前，最多发送1条消息\",\"color_day\":\"#9499A0\",\"color_nig\":\"#9499A0\"}]"
352
382
}
353
383
```
384
385
## 粉丝团消息类型
386
387
以下消息类型仅常见于粉丝团中的系统消息（`receiver_type` 为 `2` 且 `sender_uid` 为 `0`）
388
389
@@ -943,8 +943,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
943
943
944
944
**url参数：**
945
945
946
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
947
| ------ | ---- | ----------------- | ------ | --------------------------------- |
946
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
947
| ------ | ---- | ----------------- | ------ | ------------------- |
948
948
| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 |
949
949
950
950
**json回复：**
@@ -954,8 +954,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
954
954
| 字段 | 类型 | 内容 | 备注 |
955
955
| ------- | ----- | -------- | --------------------------- |
956
956
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
957
| msg | str | 错误信息 | 默认为空 |
958
| message | str | 错误信息 | 默认为空 |
957
| message | str | 错误信息 | 默认为0 |
958
| ttl | num | 1 | |
959
959
| data | array | 信息本体 | 用户信息随机排序 |
960
960
961
961
`data`数组：
@@ -972,7 +972,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
972
972
| ------- | ---- | ------------ | -------------------- |
973
973
| mid | num | mid | |
974
974
| name | str | 昵称 | |
975
| sex | str | 性别 | 男/女/保密 |
976
975
| face | str | 头像链接 | |
977
976
| sign | str | 签名 | |
978
977
| rank | num | 用户权限等级 | |
@@ -995,34 +994,31 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
995
994
```json
996
995
{
997
996
"code": 0,
998
"msg": "",
999
997
"message": "",
998
"ttl": 1,
1000
999
"data": [{
1001
1000
"mid": 1,
1002
1001
"name": "bishi",
1003
"sex": "男",
1004
"face": "https://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
1002
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
1005
1003
"sign": "",
1006
1004
"rank": 10000,
1007
"level": 4,
1005
"level": 6,
1008
1006
"silence": 0
1009
1007
}, {
1010
1008
"mid": 2,
1011
1009
"name": "碧诗",
1012
"sex": "男",
1013
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
1014
"sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”",
1010
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
1011
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
1015
1012
"rank": 20000,
1016
1013
"level": 6,
1017
1014
"silence": 0
1018
1015
}, {
1019
1016
"mid": 3,
1020
1017
"name": "囧囧倉",
1021
"sex": "男",
1022
"face": "https://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
1018
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
1023
1019
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
1024
1020
"rank": 10000,
1025
"level": 5,
1021
"level": 6,
1026
1022
"silence": 0
1027
1023
}]
1028
1024
}