diff --git a/docs/message/msg.md b/docs/message/msg.md index ce7f20b..a3c8f96 100644 --- a/docs/message/msg.md +++ b/docs/message/msg.md @@ -35,9 +35,9 @@ | ------------- | ---- | ------------------ | -------------------------- | | at | num | 未读at数 | | | chat | num | 0 | 仅旧接口,**作用尚不明确** | -| coin | num | 未读投币数 | 目前恒为 `0` | -| danmu | num | 未读弹幕数 | 目前恒为 `0` | -| favorite | num | 未读收藏数 | 目前恒为 `0` | +| coin | num | 未读投币数 | | +| danmu | num | 未读弹幕数 | | +| favorite | num | 未读收藏数 | | | like | num | 未读点赞数 | | | recv_like | num | 未读点赞数 | 同 `like` | | recv_reply | num | 未读回复数 | 同 `reply` | diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md index 860628b..eeb1eac 100644 --- a/docs/message/private_msg.md +++ b/docs/message/private_msg.md @@ -24,11 +24,11 @@ | status | num | 会话状态 | 详细信息有待补充 | | max_seqno | num | 最近一条消息的序列号 | | | new_push_msg | num | 是否有新推送的消息 | | -| setting | num | 推送设置 | 0:接收推送
1:不接收推送 | -| is_guardian | num | (?) | 在用户会话中有效
**作用尚不明确** | +| setting | num | 推送设置 | 0:接收推送
1:不接收推送
2:(?) | +| is_guardian | num | 自己是否为对方的骑士(?) | 在用户会话中有效
0:否
2:是(?) | | is_intercept | num | 会话是否被拦截 | | | is_trust | num | 是否信任此会话 | 若为 `1`,则表示此会话之前被拦截过,但用户选择信任本会话 | -| system_msg_type | num | 系统会话类型 | 0:非系统会话
1:主播小助手
7:UP主小助手
8:客服消息 | +| system_msg_type | num | 系统会话类型 | 0:非系统会话
1:主播小助手
5:系统通知(?)
7:UP主小助手
8:客服消息 | | account_info | obj | 会话信息 | 仅在系统会话中出现 | | live_status | num | 用户是否正在直播 | 在用户会话中有效,其他会话中为 `0` | | biz_msg_unread_count | num | 未读通知消息数 | | @@ -79,8 +79,8 @@ | 2 | Android | | | 3 | H5 | | | 4 | PC客户端 | | -| 5 | 推送消息 | 包括:官方向大多数用户自动发送的私信(如:UP主小助手的推广)等 | -| 6 | 通知消息 | 包括:特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息(如:UP主小助手的稿件审核状态通知)等 | +| 5 | 官方推送消息 | 包括:官方向大多数用户自动发送的私信(如:UP主小助手的推广)等 | +| 6 | 推送/通知消息 | 包括:特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息(如:UP主小助手的稿件审核状态通知)等 | | 7 | Web | | | 8 | 自动回复 - 被关注回复 | B站前端会显示“此条消息为自动回复” | | 9 | 自动回复 - 收到消息回复 | B站前端会显示“此条消息为自动回复” | @@ -103,12 +103,13 @@ **URL参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------------ | ---- | -------------------- | ------ | -------------------------------------------------------------------------- | -| unread_type | num | 未读类型 | 非必要 | 0:所有
1:仅已关注
2:仅未关注
3:仅被拦截 (须同时设置参数 `show_dustbin=1`)
默认为 `0` | -| show_dustbin | num | 是否返回被拦截私信数 | 非必要 | 0:否
1:是 | -| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` | -| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------------------ | ---- | -------------------------- | ------ | -------------------------------------------------------------------------- | +| unread_type | num | 未读类型 | 非必要 | 0:所有
1:仅已关注
2:仅未关注
3:仅被拦截 (须同时设置参数 `show_dustbin=1`)
默认为 `0` | +| show_unfollow_list | num | 是否返回未关注人推送消息数 | 非必要 | 0:否
1:是 | +| show_dustbin | num | 是否返回被拦截私信数 | 非必要 | 0:否
1:是 | +| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` | +| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 | **json回复:** @@ -142,6 +143,7 @@ ```shell curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \ --data-urlencode 'unread_type=0' \ + --data-urlencode 'show_unfollow_list=1' \ --data-urlencode 'show_dustbin=1' \ --data-urlencode 'build=0' \ --data-urlencode 'mobi_app=web' \ @@ -184,7 +186,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------- | ---- | -------------------- | ------ | ------------------------- | -| session_type | num | 会话类型 | 必要 | 1:所有
2:未关注人
3:粉丝团
7:系统消息(?) | +| session_type | num | 会话类型 | 必要 | 1:未被折叠
2:未关注人
3:粉丝团
4:所有
5:被拦截
7:系统消息(?) | | group_fold | num | 是否折叠粉丝团消息 | 非必要 | 0:否
1:是 | | unfollow_fold | num | 是否折叠未关注人消息 | 非必要 | 0:否
1:是 | | sort_rule | num | 排序方式 | 非必要 | 1、2:按会话时间逆向排序
3:按已读时间逆向排序
其他:用户按会话时间逆向排序,粉丝团按加群时间正向排序(?) | diff --git a/docs/message/private_msg_content.md b/docs/message/private_msg_content.md index 29842be..6255370 100644 --- a/docs/message/private_msg_content.md +++ b/docs/message/private_msg_content.md @@ -560,14 +560,23 @@ 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------------------ | ---- | -------------------- | ---------------- | -| content_ | str | 消息内容 | | -| showLike_ | num | 是否显示点赞按钮 | | -| showChange_ | num | 是否显示修改内容按钮 | | -| gptSessionId_ | num | GPT 会话 id | | -| gptBindQuery_ | num | (?) | **作用尚不明确** | -| sessionClosedLine_ | num | (?) | **作用尚不明确** | +| 字段 | 类型 | 内容 | 备注 | +| ------------------- | ---- | -------------------- | ---------------- | +| content | obj | 富文本内容 | | +| show_like | bool | 是否显示点赞按钮 | | +| show_change | bool | 是否显示修改内容按钮 | | +| gpt_session_id | num | GPT 会话 id | | +| gpt_bind_query | str | (?) | **作用尚不明确** | +| session_closed_line | str | (?) | **作用尚不明确** | +| voice_url | str | 语音 url(?) | | +| sub_type | num | 子类型(?) | | +| voice_time | num | 语音时长(?) | | + +`content`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---------------- | +| paragraphs | array | 段落列表 | 详细信息有待补充 | **示例:**