返回提交历史
Modified
docs/message/private_msg.md
+18
-16
Modified
docs/message/private_msg_content.md
+108
-24
Modified
docs/user/info.md
+1
-1
Modified
docs/user/relation.md
+1
-1
XFEstudio/bilibili-API-collect
update
b8da0e5
代码差异
4 个文件
+128
-42
@@ -10,21 +10,22 @@
10
10
11
11
注：私信主体对象≠[私信内容对象](private_msg_content.md)
12
12
13
| 字段 | 类型 | 内容 | 备注 |
14
| ---------------- | ---- | ------------------ | -------------------------------------------------------------- |
15
| sender_uid | num | 发送者mid | |
16
| receiver_type | num | 接收者类型 | 1：用户<br />2：粉丝团 |
17
| receiver_id | num | 接收者id | `receiver_type` 为 `1` 时表示用户 mid，为 `2` 时表示应援团 id |
18
| msg_type | num | 消息类型 | 详见[私信消息类型、内容说明](private_msg_content.md) |
19
| content | str | 消息内容 | [私信内容对象](private_msg_content.md)经过 JSON 序列化后的文本 |
20
| msg_seqno | num | 消息序列号 | 按照时间顺序从小到大 |
21
| timestamp | num | 消息发送秒级时间戳 | |
22
| at_uids | 有效时：array<br />无效时：null | at的成员mid | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员 |
23
| msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） |
24
| msg_status | num | 消息状态 | 0：正常<br />1：被撤回（接口仍能返回被撤回的私信内容）<br />2：被系统撤回（私信将不会显示在前端，B站接口也不会返回被系统撤回的私信）<br />51：（？） |
25
| notify_code | str | 通知代码 | 发送通知时使用，以下划线 `_` 分割，第 1 项表示主业务 id，第 2 项表示子业务 id；若这条私信非通知则为空文本；详细信息有待补充 |
26
| new_face_version | num | 表情包版本 | 为 `0` 或无此项表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 |
27
| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表) |
13
| 字段 | 类型 | 内容 | 备注 |
14
| ---------------- | ---- | -------------- | -------------------------------------------------------------- |
15
| sender_uid | num | 发送者mid | |
16
| receiver_type | num | 接收者类型 | 1：用户<br />2：粉丝团 |
17
| receiver_id | num | 接收者id | `receiver_type` 为 `1` 时表示用户 mid，为 `2` 时表示应援团 id |
18
| msg_type | num | 消息类型 | 详见[私信消息类型、内容说明](private_msg_content.md) |
19
| content | str | 消息内容 | [私信内容对象](private_msg_content.md)经过 JSON 序列化后的文本 |
20
| msg_seqno | num | 消息序列号 | 按照时间顺序从小到大 |
21
| timestamp | num | 消息发送时间 | 秒级时间戳 |
22
| at_uids | 有效时：array<br />无效时：null | at的成员mid | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员 |
23
| msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） |
24
| msg_status | num | 消息状态 | 0：正常<br />1：被撤回（接口仍能返回被撤回的私信内容）<br />2：被系统撤回（私信将不会显示在前端，B站接口也不会返回被系统撤回的私信）<br />50：图片已失效（私信内容为一张提示“图片出现问题”的图片） |
25
| sys_cancel | bool | 是否为系统撤回 | 仅当消息类型为 `5` 且此项值为 `true` 时有此项；若此项值为 `true`，表示目标消息是被系统撤回的 |
26
| notify_code | str | 通知代码 | 发送通知时使用，以下划线 `_` 分割，第 1 项表示主业务 id，第 2 项表示子业务 id；若这条私信非通知则为空文本；详细信息有待补充 |
27
| new_face_version | num | 表情包版本 | 为 `0` 或无此项表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 |
28
| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表) |
28
29
29
30
`私信主体对象`中的`at_uids`数组：
30
31
@@ -52,6 +53,7 @@
52
53
| 11 | 自动回复 - 大航海上船回复 | |
53
54
| 12 | 自动推送 - UP 主赠言 | 在以前稿件的自动推送与其附带的 UP 主赠言是 2 条不同的私信（其中 UP 主赠言的消息来源代码为 12），现在 UP 主赠言已被合并成为稿件自动推送的一部分 |
54
55
| 13 | 应援团系统提示 | 如：应援团中的提示信息“欢迎xxx入群” |
56
| 16 | （？） | **作用尚不明确** |
55
57
| 17 | 互相关注 | 互相关注时自动发送的私信“我们已互相关注，开始聊天吧~” |
56
58
| 18 | 系统提示 | 如：“对方主动回复或关注你前，最多发送1条消息” |
57
59
| 19 | AI | 如：给[搜索AI助手测试版](https://space.bilibili.com/1400565964/)发送私信时对方的自动回复 |
@@ -352,7 +354,7 @@ public class Main {
352
354
353
355
| 字段 | 类型 | 内容 | 备注 |
354
356
| ------- | ---- | -------- | ------------------------------------------------- |
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条消息~ |
357
| 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条消息~<br />25003：因对方隐私设置，暂无法给他发送聊天消息<br />25005：你已拉黑了对方，请先将对方移出黑名单后才能聊天 |
356
358
| message | str | 错误信息 | 成功时为0 |
357
359
| ttl | num | | 默认为1 |
358
360
| data | 有效时：obj<br />无效时：null | 信息本体 | |
@@ -72,6 +72,34 @@
72
72
73
73
## 分享消息（`msg_type=7`）
74
74
75
根对象：
76
77
| 字段 | 类型 | 内容 | 备注 |
78
| ----------- | ---- | ---------------- | -------------------------------------------------------------- |
79
| author | str | 分享内容作者 | 此项不实时更新，在发送私信时设置（非必要） |
80
| headline | str | 分享内容主标题 | 比 `title` 更突出；此项不实时更新，在发送私信时设置（非必要） |
81
| id | num | 分享内容id | |
82
| source | num | 分享内容类型 | ~~1：小视频~~（已弃用）<br />2：相簿<br />3：纯文字<br />4：直播<br />5：视频<br />6：专栏<br />7：番剧（`id` 为 season_id）<br />8：音乐<br />9：国产动画（`id` 为 AV 号）<br />10：图片<br />11：动态<br />16：番剧（`id` 为 epid）<br />17：番剧 |
83
| source_desc | str | 分享内容类型说明 | 仅当 `source` 值为 `16` 时有此项 |
84
| thumb | str | 分享内容封面 | 此项不实时更新，在发送私信时设置 |
85
| title | str | 分享内容标题 | 此项不实时更新，在发送私信时设置 |
86
| url | str | 分享内容url | （非必要） |
87
| bvid | str | 视频BV号 | （非必要） |
88
89
**示例：**
90
91
```json
92
{
93
"author": "社会易姐QwQ",
94
"headline": "",
95
"id": 246551172,
96
"source": 5,
97
"thumb": "http://i2.hdslb.com/bfs/archive/14ba78056f946ece8c954a10677ef6b073edb178.jpg",
98
"title": "合 成 大 東 瓜",
99
"bvid": "BV16v411e7CW"
100
}
101
```
102
75
103
## 小程序消息（`msg_type=9`）
76
104
77
105
待补充
@@ -107,20 +135,16 @@
107
135
"text": "你预约的直播已开始，快来围观吧~",
108
136
"jump_text": "进入直播间",
109
137
"jump_uri": "https://live.bilibili.com/22747055?broadcast_type=0&is_room_feed=1&live_from=27040",
110
"modules": [
111
{
112
"title": "预约主题",
113
"detail": "2024哔哩哔哩拜年纪"
114
},
115
{
116
"title": "开播时间",
117
"detail": "2024-02-09 19:32"
118
},
119
{
120
"title": "UP主",
121
"detail": "哔哩哔哩拜年纪"
122
}
123
],
138
"modules": [{
139
"title": "预约主题",
140
"detail": "2024哔哩哔哩拜年纪"
141
}, {
142
"title": "开播时间",
143
"detail": "2024-02-09 19:32"
144
}, {
145
"title": "UP主",
146
"detail": "哔哩哔哩拜年纪"
147
}],
124
148
"jump_text_2": "",
125
149
"jump_uri_2": "",
126
150
"jump_text_3": "",
@@ -231,28 +255,88 @@
231
255
232
256
此类型消息仅可接收，不可直接发送
233
257
258
根对象：
259
260
| 字段 | 类型 | 内容 | 备注 |
261
| -------- | ---- | ------------------- | -------------------- |
262
| pic_url | str | 图片url | |
263
| jump_url | str | 点击图片跳转到的url | |
264
| title | str | 文字说明 | 显示在聊天列表的文字 |
265
266
**示例：**
267
268
```json
269
{
270
"pic_url": "http://i0.hdslb.com/bfs/location/9e57aff7245c226c05ba46ddd1e82667f74d5a06.png",
271
"jump_url": "https://www.bilibili.com/h5/mall/suit/detail?navhide=1&id=66359&from=Banner",
272
"title": "原神，启动！"
273
}
274
```
234
275
235
276
## 被关注时的自动推送消息（`msg_type=16`）
236
277
278
**示例：**
279
280
```json
281
{
282
"main_title": "更多宝藏内容",
283
"reply_content": "感谢大佬关注哦～[doge][脱单doge][doge]\n这里是科技区底边小UP，日常瞎折腾，软硬件电路程序网络服务器都折腾，视频月更风格硬核略小众，咕咕咕.....\n老大二了，就不中二了\n有什么好的建议欢迎私信",
284
"sub_cards": [{
285
"card_id": 379743801,
286
"card_type": 1,
287
"jump_url": "https://b23.tv/BV1hZ4y197Cz",
288
"cover_url": "http://i2.hdslb.com/bfs/archive/bfb87f033272926efe6ff4caee8e6c49c07ff6fe.jpg",
289
"field1": "【宿舍评测】性能与便携两全 华为matebook E 2022深度体验及伪开箱",
290
"field2": "2021-12-10",
291
"field3": "195299",
292
"icon3": 1,
293
"field4": "479",
294
"icon4": 3
295
}, {
296
"card_id": 768716232,
297
"card_type": 1,
298
"jump_url": "https://b23.tv/BV13r4y187R8",
299
"cover_url": "http://i1.hdslb.com/bfs/archive/bb1d41ef0c17c2df25c8b6ef98f01466bdee0c1f.jpg",
300
"field1": "【BadApple】使用古董示波器Aron BS-601播放BadApple!!!",
301
"field2": "2022-05-03",
302
"field3": "151613",
303
"icon3": 1,
304
"field4": "297",
305
"icon4": 3
306
}, {
307
"card_id": 524989935,
308
"card_type": 1,
309
"jump_url": "https://b23.tv/BV17M411E7Kq",
310
"cover_url": "http://i1.hdslb.com/bfs/archive/17335854dfad9d7990943d8cc6dc07c85912b103.jpg",
311
"field1": "【拆解】华为 Matebook E 更换固态硬盘：从未见过如此好拆的二合一",
312
"field2": "2023-02-24",
313
"field3": "56077",
314
"icon3": 1,
315
"field4": "102",
316
"icon4": 3
317
}]
318
}
319
```
320
237
321
## 系统提示消息（`msg_type=18`）
238
322
239
323
此类型消息仅可接收，不可直接发送
240
324
241
325
根对象：
242
326
243
| 字段 | 类型 | 内容 | 备注 |
244
| ------- | ----- | -------- | ---- |
245
| content | array | 提示列表 | |
327
| 字段 | 类型 | 内容 | 备注 |
328
| ------- | ---- | -------- | ---------------------- |
329
| content | str | 提示列表 | 经过序列化后的JSON数组 |
246
330
247
`content`数组：
331
`content`文本经JSON解析后的数组：
248
332
249
| 项 | 类型 | 内容 | 备注 |
250
| ---- | ---- | --------- | ---------------------- |
251
| 0 | str | 提示1 | 经过序列化后的JSON对象 |
252
| n | str | 提示(n+1) | |
253
| …… | str | …… | …… |
333
| 项 | 类型 | 内容 | 备注 |
334
| ---- | ---- | --------- | ---- |
335
| 0 | obj | 提示1 | |
336
| n | obj | 提示(n+1) | |
337
| …… | obj | …… | …… |
254
338
255
`content`数组中的JSON文本解析后的对象：
339
`content`文本经JSON解析后的数组中的对象：
256
340
257
341
| 字段 | 类型 | 内容 | 备注 |
258
342
| --------- | ---- | ------------------------ | ----------- |
@@ -939,7 +939,7 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
939
939
940
940
认证方式：Cookie(SESSDATA)
941
941
942
本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以同时获取 40000 多个用户的信息）
942
本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以一次性获取 40000 多个用户的信息）
943
943
944
944
**url参数：**
945
945
@@ -1303,7 +1303,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
1303
1303
1304
1304
| 字段 | 类型 | 内容 | 备注 |
1305
1305
| ------- | ---- | -------- | ------------------------------------------------------------ |
1306
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22003：用户位于黑名单<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />40061：用户不存在 |
1306
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22002：因对方隐私设置，你还不能关注<br />22003：关注失败，请将该用户移除黑名单之后再试<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />22120：重复加入黑名单<br />40061：用户不存在 |
1307
1307
| message | str | 错误信息 | 默认为0 |
1308
1308
| ttl | num | 1 | |
1309
1309