返回提交历史
Modified
docs/message/msg.md
+3
-3
Modified
docs/message/private_msg.md
+14
-12
Modified
docs/message/private_msg_content.md
+17
-8
XFEstudio/bilibili-API-collect
update docs
8152785
代码差异
3 个文件
+34
-23
@@ -35,9 +35,9 @@
35
35
| ------------- | ---- | ------------------ | -------------------------- |
36
36
| at | num | 未读at数 | |
37
37
| chat | num | 0 | 仅旧接口，**作用尚不明确** |
38
| coin | num | 未读投币数 | 目前恒为 `0` |
39
| danmu | num | 未读弹幕数 | 目前恒为 `0` |
40
| favorite | num | 未读收藏数 | 目前恒为 `0` |
38
| coin | num | 未读投币数 | |
39
| danmu | num | 未读弹幕数 | |
40
| favorite | num | 未读收藏数 | |
41
41
| like | num | 未读点赞数 | |
42
42
| recv_like | num | 未读点赞数 | 同 `like` |
43
43
| recv_reply | num | 未读回复数 | 同 `reply` |
@@ -24,11 +24,11 @@
24
24
| status | num | 会话状态 | 详细信息有待补充 |
25
25
| max_seqno | num | 最近一条消息的序列号 | |
26
26
| new_push_msg | num | 是否有新推送的消息 | |
27
| setting | num | 推送设置 | 0：接收推送<br />1：不接收推送 |
28
| is_guardian | num | （？） | 在用户会话中有效<br />**作用尚不明确** |
27
| setting | num | 推送设置 | 0：接收推送<br />1：不接收推送<br />2：（？） |
28
| is_guardian | num | 自己是否为对方的骑士（？） | 在用户会话中有效<br />0：否<br />2：是（？） |
29
29
| is_intercept | num | 会话是否被拦截 | |
30
30
| is_trust | num | 是否信任此会话 | 若为 `1`，则表示此会话之前被拦截过，但用户选择信任本会话 |
31
| system_msg_type | num | 系统会话类型 | 0：非系统会话<br />1：主播小助手<br />7：UP主小助手<br />8：客服消息 |
31
| system_msg_type | num | 系统会话类型 | 0：非系统会话<br />1：主播小助手<br />5：系统通知（？）<br />7：UP主小助手<br />8：客服消息 |
32
32
| account_info | obj | 会话信息 | 仅在系统会话中出现 |
33
33
| live_status | num | 用户是否正在直播 | 在用户会话中有效，其他会话中为 `0` |
34
34
| biz_msg_unread_count | num | 未读通知消息数 | |
@@ -79,8 +79,8 @@
79
79
| 2 | Android | |
80
80
| 3 | H5 | |
81
81
| 4 | PC客户端 | |
82
| 5 | 推送消息 | 包括：官方向大多数用户自动发送的私信（如：UP主小助手的推广）等 |
83
| 6 | 通知消息 | 包括：特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息（如：UP主小助手的稿件审核状态通知）等 |
82
| 5 | 官方推送消息 | 包括：官方向大多数用户自动发送的私信（如：UP主小助手的推广）等 |
83
| 6 | 推送/通知消息 | 包括：特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息（如：UP主小助手的稿件审核状态通知）等 |
84
84
| 7 | Web | |
85
85
| 8 | 自动回复 - 被关注回复 | B站前端会显示“此条消息为自动回复” |
86
86
| 9 | 自动回复 - 收到消息回复 | B站前端会显示“此条消息为自动回复” |
@@ -103,12 +103,13 @@
103
103
104
104
**URL参数:**
105
105
106
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
107
| ------------ | ---- | -------------------- | ------ | -------------------------------------------------------------------------- |
108
| unread_type | num | 未读类型 | 非必要 | 0：所有<br />1：仅已关注<br />2：仅未关注<br />3：仅被拦截 (须同时设置参数 `show_dustbin=1`)<br />默认为 `0` |
109
| show_dustbin | num | 是否返回被拦截私信数 | 非必要 | 0：否<br />1：是 |
110
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
111
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
106
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
107
| ------------------ | ---- | -------------------------- | ------ | -------------------------------------------------------------------------- |
108
| unread_type | num | 未读类型 | 非必要 | 0：所有<br />1：仅已关注<br />2：仅未关注<br />3：仅被拦截 (须同时设置参数 `show_dustbin=1`)<br />默认为 `0` |
109
| show_unfollow_list | num | 是否返回未关注人推送消息数 | 非必要 | 0：否<br />1：是 |
110
| show_dustbin | num | 是否返回被拦截私信数 | 非必要 | 0：否<br />1：是 |
111
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
112
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
112
113
113
114
**json回复：**
114
115
@@ -142,6 +143,7 @@
142
143
```shell
143
144
curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
144
145
--data-urlencode 'unread_type=0' \
146
--data-urlencode 'show_unfollow_list=1' \
145
147
--data-urlencode 'show_dustbin=1' \
146
148
--data-urlencode 'build=0' \
147
149
--data-urlencode 'mobi_app=web' \
@@ -184,7 +186,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
184
186
185
187
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
186
188
| ------------- | ---- | -------------------- | ------ | ------------------------- |
187
| session_type | num | 会话类型 | 必要 | 1：所有<br />2：未关注人<br />3：粉丝团<br />7：系统消息（？） |
189
| session_type | num | 会话类型 | 必要 | 1：未被折叠<br />2：未关注人<br />3：粉丝团<br />4：所有<br />5：被拦截<br />7：系统消息（？） |
188
190
| group_fold | num | 是否折叠粉丝团消息 | 非必要 | 0：否<br />1：是 |
189
191
| unfollow_fold | num | 是否折叠未关注人消息 | 非必要 | 0：否<br />1：是 |
190
192
| sort_rule | num | 排序方式 | 非必要 | 1、2：按会话时间逆向排序<br />3：按已读时间逆向排序<br />其他：用户按会话时间逆向排序，粉丝团按加群时间正向排序（？） |
@@ -560,14 +560,23 @@
560
560
561
561
根对象：
562
562
563
| 字段 | 类型 | 内容 | 备注 |
564
| ------------------ | ---- | -------------------- | ---------------- |
565
| content_ | str | 消息内容 | |
566
| showLike_ | num | 是否显示点赞按钮 | |
567
| showChange_ | num | 是否显示修改内容按钮 | |
568
| gptSessionId_ | num | GPT 会话 id | |
569
| gptBindQuery_ | num | （？） | **作用尚不明确** |
570
| sessionClosedLine_ | num | （？） | **作用尚不明确** |
563
| 字段 | 类型 | 内容 | 备注 |
564
| ------------------- | ---- | -------------------- | ---------------- |
565
| content | obj | 富文本内容 | |
566
| show_like | bool | 是否显示点赞按钮 | |
567
| show_change | bool | 是否显示修改内容按钮 | |
568
| gpt_session_id | num | GPT 会话 id | |
569
| gpt_bind_query | str | （？） | **作用尚不明确** |
570
| session_closed_line | str | （？） | **作用尚不明确** |
571
| voice_url | str | 语音 url（？） | |
572
| sub_type | num | 子类型（？） | |
573
| voice_time | num | 语音时长（？） | |
574
575
`content`对象：
576
577
| 字段 | 类型 | 内容 | 备注 |
578
| ---------- | ----- | -------- | ---------------- |
579
| paragraphs | array | 段落列表 | 详细信息有待补充 |
571
580
572
581
**示例：**
573
582