返回提交历史
Modified
docs/message/private_msg.md
+7
-7
Modified
docs/message/private_msg_content.md
+15
-15
XFEstudio/bilibili-API-collect
update docs
44003bc
代码差异
2 个文件
+22
-22
@@ -8,7 +8,7 @@
8
8
| -------------------- | ---- | -------------------------------- | --------------------------------------------------- |
9
9
| talker_id | num | 聊天对象的id | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id |
10
10
| session_type | num | 聊天对象的类型 | 1：用户<br />2：粉丝团 |
11
| at_seqno | num | 最近一次未读at自己的消息的序列号 | 在粉丝团会话中有效，若没有未读的at自己的消息则为 `0` |
11
| at_seqno | num | 最近一次未读at自己的消息的序列号 | 在粉丝团会话中有效，若没有未读的 at 自己的消息则为 `0` |
12
12
| top_ts | num | 置顶该会话的时间 | 微秒级时间戳；若未置顶该会话则为 `0` |
13
13
| group_name | str | 粉丝团名称 | 在粉丝团会话中有效 |
14
14
| group_cover | str | 粉丝团头像 | 在粉丝团会话中有效 |
@@ -18,16 +18,16 @@
18
18
| ack_ts | num | 最近一次已读时间 | 微秒级时间戳 |
19
19
| session_ts | num | 会话时间 | 微秒级时间戳 |
20
20
| unread_count | num | 未读消息数 | |
21
| last_msg | obj | 最近的一条消息 | 详见[私信主体对象](#私信主体对象) |
22
| group_type | num | 粉丝团类型 | 在粉丝团时有效<br />0：应援团<br />2：官方群 |
23
| can_fold | num | （？） | **作用尚不明确** |
21
| last_msg | 有效时：obj<br />无效时：null | 最近的一条消息 | 详见[私信主体对象](#私信主体对象) |
22
| group_type | num | 粉丝团类型 | 在粉丝团时有效<br />0：应援团<br />2：官方群（如：ID 为 10 的粉丝团） |
23
| can_fold | num | 会话是否可被折叠入未关注人消息 | 在用户会话中有效 |
24
24
| status | num | 会话状态 | 详细信息有待补充 |
25
25
| max_seqno | num | 最近一条消息的序列号 | |
26
26
| new_push_msg | num | 是否有新推送的消息 | |
27
| setting | num | （？） | **作用尚不明确** |
28
| is_guardian | num | （？） | **作用尚不明确** |
27
| setting | num | 推送设置 | 0：接收推送<br />1：不接收推送<br />2：（？） |
28
| is_guardian | num | （？） | 在用户会话中有效<br />**作用尚不明确** |
29
29
| is_intercept | num | 会话是否被拦截 | |
30
| is_trust | num | 是否已设置不拦截此会话 | 若为 `1`，则表示此会话之前被拦截过，但用户选择信任本会话 |
30
| is_trust | num | 是否信任此会话 | 若为 `1`，则表示此会话之前被拦截过，但用户选择信任本会话 |
31
31
| system_msg_type | num | 系统消息类型 | 0：非系统消息<br />1：主播小助手<br />7：UP主小助手<br />8：客服消息 |
32
32
| account_info | obj | 会话信息 | 仅在系统消息中出现 |
33
33
| live_status | num | 用户是否正在直播 | 在用户会话中有效 |
@@ -441,30 +441,30 @@
441
441
| ------------- | ----- | ---------------- | -------------------------------------------- |
442
442
| main_title | str | 主标题 | 一般为 `更多宝藏内容` |
443
443
| reply_content | str | 自动回复文字内容 | 仅在聊天列表中的消息概要中显示此内容，在私信内容中不显示 |
444
| sub_cards | array | 推送的作品列表 | 一般为3个 |
444
| sub_cards | array | 推送的稿件列表 | 一般为3个 |
445
445
446
446
`sub_cards`数组：
447
447
448
448
| 项 | 类型 | 内容 | 备注 |
449
449
| ---- | ---- | --------- | ---- |
450
| 0 | obj | 作品1 | |
451
| n | obj | 作品(n+1) | |
450
| 0 | obj | 稿件1 | |
451
| n | obj | 稿件(n+1) | |
452
452
| …… | obj | …… | …… |
453
453
454
454
`sub_cards`数组中的对象：
455
455
456
| 字段 | 类型 | 内容 | 备注 |
457
| --------- | ---- | ------------ | -------------------------------------------------------------- |
458
| card_id | num | 作品id | 当作品为视频时：表示AV号<br />当作品为专栏时：表示CV号 |
459
| card_type | num | 作品类型 | 1：视频 |
460
| jump_url | str | 作品链接 | |
461
| cover_url | str | 作品封面url | |
462
| field1 | str | 作品标题 | |
463
| field2 | str | 作品发布时间 | 格式：`YYYY-MM-DD` |
464
| field3 | str | 字段3 | 当作品为视频时：表示作品播放量<br />当作品为专栏时：表示阅读量 |
465
| icon3 | num | 图标3类型 | 1：播放量 |
466
| field4 | str | 字段4 | 当作品为视频时：表示作品弹幕数<br />当作品为专栏时：表示评论数 |
467
| icon4 | num | 图标4类型 | 3：弹幕数 |
456
| 字段 | 类型 | 内容 | 备注 |
457
| --------- | ---- | ------------ | -------------------------------- |
458
| card_id | num | 稿件AV号 | |
459
| card_type | num | 稿件类型 | 一般为 `1` |
460
| jump_url | str | 稿件链接 | |
461
| cover_url | str | 稿件封面url | 此项不实时更新，在发送私信时设置 |
462
| field1 | str | 稿件标题 | 此项不实时更新，在发送私信时设置 |
463
| field2 | str | 稿件发布时间 | 格式：`YYYY-MM-DD` |
464
| field3 | str | 稿件播放量 | 此项不实时更新，在发送私信时设置 |
465
| icon3 | num | 图标3类型 | 1：播放量 |
466
| field4 | str | 稿件弹幕数 | 此项不实时更新，在发送私信时设置 |
467
| icon4 | num | 图标4类型 | 3：弹幕数 |
468
468
469
469
**示例：**
470
470