返回提交历史
Modified
docs/message/private_msg.md
+32
-15
Modified
docs/message/private_msg_content.md
+9
-9
XFEstudio/bilibili-API-collect
update
b6fb3b5
代码差异
2 个文件
+41
-24
@@ -26,7 +26,7 @@
26
26
| new_face_version | num | 表情包版本 | 为 `0` 或无此项表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 |
27
27
| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表) |
28
28
29
`at_uids`数组：
29
`私信主体对象`中的`at_uids`数组：
30
30
31
31
| 项 | 类型 | 内容 | 备注 |
32
32
| ---- | ---- | --------- | ------- |
@@ -167,7 +167,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
167
167
| max_seqno | num | 所有消息中最大的序列号（最晚） | 若无私信则为 `0` |
168
168
| e_infos | array | 聊天表情列表 | 若私信列表中无表情则无此项 |
169
169
170
`messages`数组：
170
`data`对象中的`messages`数组：
171
171
172
172
| 项 | 类型 | 内容 | 备注 |
173
173
| ---- | ---- | --------- | --------------------------------- |
@@ -175,7 +175,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
175
175
| n | obj | 私信(n+1) | |
176
176
| …… | obj | …… | …… |
177
177
178
`e_infos`数组：
178
`data`对象中的`e_infos`数组：
179
179
180
180
| 项 | 类型 | 内容 | 备注 |
181
181
| ---- | ---- | --------- | ---- |
@@ -183,7 +183,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
183
183
| n | obj | 表情(n+1) | |
184
184
| …… | obj | …… | …… |
185
185
186
`e_infos`数组中的对象：
186
`data`对象中的`e_infos`数组中的对象：
187
187
188
188
| 字段 | 类型 | 内容 | 备注 |
189
189
| ------- | ---- | ----------- | ----------------------------------- |
@@ -352,20 +352,38 @@ public class Main {
352
352
353
353
| 字段 | 类型 | 内容 | 备注 |
354
354
| ------- | ---- | -------- | ------------------------------------------------- |
355
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />21047：你最多发送1条消息，对方回复或者关注你后可以继续发消息~ |
356
| message | str | 错误信息 | 默认为0 |
355
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />10005：msgkey不存在<br />21007：消息过长，无法发送<br />21026：不能给自己发送消息哦~<br />21035：该类消息暂时无法发送<br />21037：图片格式不合法，不要调戏接口啦<br />21041：消息已超期，不能撤回了哦<br />21042：消息已经撤回了哦<br />21046：你发消息的频率太高了，请在24小时后再发吧~<br />21047：你最多发送1条消息，对方回复或者关注你后可以继续发消息~ |
356
| message | str | 错误信息 | 成功时为0 |
357
357
| ttl | num | | 默认为1 |
358
| data | obj | 信息本体 | 出错时无此项 |
358
| data | 有效时：obj<br />无效时：null | 信息本体 | |
359
359
360
360
`data`对象：
361
361
362
| 字段 | 类型 | 内容 | 备注 |
363
| ------------- | ---- | ---------- | --------------------------------------------------------------------- |
364
| msg_key | num | 消息唯一id | |
365
| msg_content | str | 发送的消息 | 仅当请求参数中`msg[msg_type]`为`1`且`msg[receiver_type]`为`1`时有此项 |
366
| key_hit_infos | obj | 触发的提示 | 仅当请求参数中`msg[msg_type]`为`1`且`msg[receiver_type]`为`1`时有此项 |
362
| 字段 | 类型 | 内容 | 备注 |
363
| ------------- | ----- | ---------- | --------------------------------------------------------------------- |
364
| msg_key | num | 消息唯一id | |
365
| e_infos | array | 表情列表 | 若私信中无表情则无此项 |
366
| msg_content | str | 发送的消息 | 仅当请求参数中`msg[msg_type]`为`1`且`msg[receiver_type]`为`1`时有此项 |
367
| key_hit_infos | obj | 触发的提示 | 仅当请求参数中`msg[msg_type]`为`1`且`msg[receiver_type]`为`1`时有此项 |
367
368
368
`data`对象中的`key_hit_infos`：
369
`data`对象中的`e_infos`数组：
370
371
| 项 | 类型 | 内容 | 备注 |
372
| ---- | ---- | --------- | ---- |
373
| 0 | obj | 表情1 | |
374
| n | obj | 表情(n+1) | |
375
| …… | obj | …… | …… |
376
377
`data`对象中的`e_infos`数组中的对象：
378
379
| 字段 | 类型 | 内容 | 备注 |
380
| ------- | ---- | ----------- | ----------------------------------- |
381
| text | str | 表情名称 | 包括左右两侧的中括号，如`[tv_doge]` |
382
| uri | str | 表情链接 | |
383
| size | num | 表情尺寸 | 1：小<br />2：大 |
384
| gif_url | str | 表情GIF链接 | 仅部分表情存在此项 |
385
386
`data`对象中的`key_hit_infos`对象：
369
387
370
388
| 字段 | 类型 | 内容 | 备注 |
371
389
| --------- | ----- | ------------ | -------------------------------------- |
@@ -373,8 +391,7 @@ public class Main {
373
391
| rule_id | num | 触发的规则id | 当触发了提示时有此项，详细信息有待补充 |
374
392
| high_text | array | 高亮的文本 | 当触发了提示时有此项 |
375
393
376
377
`data`对象中的`key_hit_infos`中的`high_text`数组：
394
`data`对象中的`key_hit_infos`对象中的`high_text`数组：
378
395
379
396
| 项 | 类型 | 内容 | 备注 |
380
397
| ---- | ---- | ------------- | ---------------- |
@@ -2,7 +2,7 @@
2
2
3
3
## 文字消息（`msg_type=1`）
4
4
5
在发送私信时，请确保下面的对象合法且 `content` 项的值为非 0 长度的文本，否则会提示 `请求错误`
5
在发送私信时，请确保下面的对象合法且 `content` 项的值为非空文本，否则会提示 `请求错误`
6
6
7
7
根对象：
8
8
@@ -54,7 +54,7 @@
54
54
55
55
内容为目标私信的 `msg_key`
56
56
57
请确保目标私信存在，且发送的私信与目标私信在同一会话内；发送此私信后，目标私信的 `msg_status` 会变成 `1`
57
请确保目标私信存在、在撤回有效期里，且与发送的私信在同一会话内；成功发送此私信后，目标私信的 `msg_status` 会变成 `1`
58
58
59
59
**示例：**
60
60
@@ -64,11 +64,11 @@
64
64
7345551441311046575
65
65
```
66
66
67
这时，私信 A 就会被撤回，并且其 `msg_status` 也会变成 `1`
67
若发送成功，则私信 A 会被撤回，并且其 `msg_status` 也会变成 `1`
68
68
69
69
## 自定义表情消息（`msg_type=6`）
70
70
71
对象结构基本同 [图片消息](#图片消息（`msg_type=6`）)
71
对象结构基本同 [图片消息](#图片消息msg_type2)
72
72
73
73
## 分享消息（`msg_type=7`）
74
74
@@ -78,26 +78,26 @@
78
78
79
79
## 通知消息（`msg_type=10`）
80
80
81
本类型消息仅可接收，不能直接发送
81
此类型消息仅可接收，不可直接发送
82
82
83
83
84
84
## 视频推送消息（`msg_type=11`）
85
85
86
本类型消息仅可接收，不能直接发送
86
此类型消息仅可接收，不可直接发送
87
87
88
88
89
89
## 专栏推送消息（`msg_type=12`）
90
90
91
本类型消息仅可接收，不能直接发送
91
此类型消息仅可接收，不可直接发送
92
92
93
93
94
94
## 图片卡片消息（`msg_type=13`）
95
95
96
本类型消息仅可接收，不能直接发送
96
此类型消息仅可接收，不可直接发送
97
97
98
98
99
99
## 被关注时的自动推送消息（`msg_type=16`）
100
100
101
101
## 系统提示消息（`msg_type=18`）
102
102
103
本类型消息仅可接收，不能直接发送
103
此类型消息仅可接收，不可直接发送