update docs
This commit is contained in:
wuziqian211
parent
7f31a2836f
commit
6e033f7fa0
@ -13,10 +13,10 @@
|
|||||||
|
|
||||||
**URL参数:**
|
**URL参数:**
|
||||||
|
|
||||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
| -------- | ---- | ---- | ------ | -------------------------- |
|
| -------- | ---- | ---------------- | ------ | ------------------------- |
|
||||||
| build | num | 0 | 不必要 | 从新接口发现, 作用尚不明确 |
|
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
|
||||||
| mobi_app | str | web | 不必要 | 从新接口发现, 作用尚不明确 |
|
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
|
||||||
|
|
||||||
**json回复：**
|
**json回复：**
|
||||||
|
|
||||||
@ -31,20 +31,20 @@
|
|||||||
|
|
||||||
`data` 对象：
|
`data` 对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ------------- | ---- | -------------- | ---------------------- |
|
| ------------- | ---- | -------------- | -------------------------- |
|
||||||
| at | num | 未读at数 | |
|
| at | num | 未读at数 | |
|
||||||
| chat | num | 0 | 作用尚不明确 |
|
| chat | num | 0 | 仅旧接口，**作用尚不明确** |
|
||||||
| coin | num | 未读投币数 | |
|
| coin | num | 未读投币数 | |
|
||||||
| danmu | num | 未读弹幕数 | |
|
| danmu | num | 未读弹幕数 | |
|
||||||
| favorite | num | 未读收藏数? | |
|
| favorite | num | 未读收藏数? | |
|
||||||
| like | num | 未读点赞数 | |
|
| like | num | 未读点赞数 | |
|
||||||
| recv_like | num | 未读点赞数 | |
|
| recv_like | num | 未读点赞数 | 同 `like` |
|
||||||
| recv_reply | num | 未读回复数 | |
|
| recv_reply | num | 未读回复数 | 同 `reply` |
|
||||||
| reply | num | 未读回复数 | |
|
| reply | num | 未读回复数 | |
|
||||||
| sys_msg | num | 未读系统通知数 | |
|
| sys_msg | num | 未读系统通知数 | |
|
||||||
| sys_msg_style | num | 1 | 仅新接口, 作用尚不明确 |
|
| sys_msg_style | num | 1 | 仅新接口, **作用尚不明确** |
|
||||||
| up | num | UP主助手信息数 | |
|
| up | num | UP主助手信息数 | |
|
||||||
|
|
||||||
**示例：**
|
**示例：**
|
||||||
|
|
||||||
|
|||||||
@ -9,10 +9,10 @@
|
|||||||
| talker_id | num | 聊天对象的id | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id |
|
| talker_id | num | 聊天对象的id | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id |
|
||||||
| session_type | num | 聊天对象的类型 | 1：用户<br />2：粉丝团 |
|
| session_type | num | 聊天对象的类型 | 1：用户<br />2：粉丝团 |
|
||||||
| at_seqno | num | 最近一次未读at自己的消息的序列号 | 在粉丝团会话中有效，若没有未读的 at 自己的消息则为 `0` |
|
| at_seqno | num | 最近一次未读at自己的消息的序列号 | 在粉丝团会话中有效，若没有未读的 at 自己的消息则为 `0` |
|
||||||
| top_ts | num | 置顶该会话的时间 | 微秒级时间戳；若未置顶该会话则为 `0` |
|
| top_ts | num | 置顶该会话的时间 | 微秒级时间戳；若未置顶该会话则为 `0`；用于判断是否置顶了会话 |
|
||||||
| group_name | str | 粉丝团名称 | 在粉丝团会话中有效 |
|
| group_name | str | 粉丝团名称 | 在粉丝团会话中有效，其他会话中为空字符串 |
|
||||||
| group_cover | str | 粉丝团头像 | 在粉丝团会话中有效 |
|
| group_cover | str | 粉丝团头像 | 在粉丝团会话中有效，其他会话中为空字符串 |
|
||||||
| is_follow | num | 是否已关注对方 | 在用户会话中有效 |
|
| is_follow | num | 是否关注了对方 | 在用户会话中有效，其他会话中为 `0` |
|
||||||
| is_dnd | num | 是否对会话设置了免打扰 | |
|
| is_dnd | num | 是否对会话设置了免打扰 | |
|
||||||
| ack_seqno | num | 最近一次已读的消息序列号 | 用于快速跳转到首条未读的消息 |
|
| ack_seqno | num | 最近一次已读的消息序列号 | 用于快速跳转到首条未读的消息 |
|
||||||
| ack_ts | num | 最近一次已读时间 | 微秒级时间戳 |
|
| ack_ts | num | 最近一次已读时间 | 微秒级时间戳 |
|
||||||
@ -30,7 +30,7 @@
|
|||||||
| is_trust | num | 是否信任此会话 | 若为 `1`，则表示此会话之前被拦截过，但用户选择信任本会话 |
|
| is_trust | num | 是否信任此会话 | 若为 `1`，则表示此会话之前被拦截过，但用户选择信任本会话 |
|
||||||
| system_msg_type | num | 系统消息类型 | 0：非系统消息<br />1：主播小助手<br />7：UP主小助手<br />8：客服消息 |
|
| system_msg_type | num | 系统消息类型 | 0：非系统消息<br />1：主播小助手<br />7：UP主小助手<br />8：客服消息 |
|
||||||
| account_info | obj | 会话信息 | 仅在系统消息中出现 |
|
| account_info | obj | 会话信息 | 仅在系统消息中出现 |
|
||||||
| live_status | num | 用户是否正在直播 | 在用户会话中有效 |
|
| live_status | num | 用户是否正在直播 | 在用户会话中有效，其他会话中为 `0` |
|
||||||
| biz_msg_unread_count | num | 未读通知消息数 | |
|
| biz_msg_unread_count | num | 未读通知消息数 | |
|
||||||
| user_label | null | （？） | **作用尚不明确** |
|
| user_label | null | （？） | **作用尚不明确** |
|
||||||
|
|
||||||
@ -79,8 +79,8 @@
|
|||||||
| 2 | Android | |
|
| 2 | Android | |
|
||||||
| 3 | H5 | |
|
| 3 | H5 | |
|
||||||
| 4 | PC客户端 | |
|
| 4 | PC客户端 | |
|
||||||
| 5 | 官方自动推送 | 包括：官方向大多数用户自动发送的私信（如：UP主小助手的推广）等 |
|
| 5 | 推送消息 | 包括：官方向大多数用户自动发送的私信（如：UP主小助手的推广）等 |
|
||||||
| 6 | 自动推送/发送 | 包括：特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息（如：UP主小助手的稿件审核状态通知）等 |
|
| 6 | 通知消息 | 包括：特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息（如：UP主小助手的稿件审核状态通知）等 |
|
||||||
| 7 | Web | |
|
| 7 | Web | |
|
||||||
| 8 | 自动回复 - 被关注回复 | B站前端会显示“此条消息为自动回复” |
|
| 8 | 自动回复 - 被关注回复 | B站前端会显示“此条消息为自动回复” |
|
||||||
| 9 | 自动回复 - 收到消息回复 | B站前端会显示“此条消息为自动回复” |
|
| 9 | 自动回复 - 收到消息回复 | B站前端会显示“此条消息为自动回复” |
|
||||||
@ -103,11 +103,11 @@
|
|||||||
|
|
||||||
**URL参数:**
|
**URL参数:**
|
||||||
|
|
||||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
| ----------- | ---- | ---- | ------ | ---- |
|
| ----------- | ---- | ---------------- | ------ | -------------------------------------------------------------------------- |
|
||||||
| build | num | 0 | 不必要 | ? |
|
| unread_type | num | 未读类型 | 非必要 | 0：所有<br />1：仅已关注<br />2：仅未关注<br />3：仅被拦截<br />默认为 `0` |
|
||||||
| mobi_app | str | web | 不必要 | ? |
|
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
|
||||||
| unread_type | num | 0 | 不必要 | ? |
|
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
|
||||||
|
|
||||||
**json回复：**
|
**json回复：**
|
||||||
|
|
||||||
@ -123,20 +123,20 @@
|
|||||||
|
|
||||||
`data` 对象：
|
`data` 对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ----------------------- | ---- | ---------------------- | ---------------- |
|
| ----------------------- | ---- | ------------------------ | ---------------- |
|
||||||
| unfollow_unread | num | 未关注用户未读私信数 | |
|
| unfollow_unread | num | 未读未关注用户私信数 | |
|
||||||
| follow_unread | num | 已关注用户未读私信数 | |
|
| follow_unread | num | 未读已关注用户私信数 | |
|
||||||
| unfollow_push_msg | num | 未读推送消息数 | |
|
| unfollow_push_msg | num | 未读未关注用户推送消息数 | |
|
||||||
| dustbin_push_msg | num | 未读被拦截的推送消息数 | |
|
| dustbin_push_msg | num | 未读被拦截的推送消息数 | |
|
||||||
| dustbin_unread | num | 未读被拦截的私信数 | |
|
| dustbin_unread | num | 未读被拦截的私信数 | |
|
||||||
| biz_msg_unfollow_unread | num | 未关注用户未读通知数 | |
|
| biz_msg_unfollow_unread | num | 未读未关注用户通知数 | |
|
||||||
| biz_msg_follow_unread | num | 已关注用户未读通知数 | |
|
| biz_msg_follow_unread | num | 未读已关注用户通知数 | |
|
||||||
| custom_unread | num | 未读客服消息数 | |
|
| custom_unread | num | 未读客服消息数 | |
|
||||||
|
|
||||||
**示例：**
|
**示例：**
|
||||||
|
|
||||||
以下信息代表未关注用户未读私信数为`1`条，已关注用户未读私信数为`6`条
|
以下信息代表未读未关注用户私信数为 `1` 条，未读已关注用户私信数为 `6` 条
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
|
curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
|
||||||
@ -204,7 +204,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
|
|||||||
| --------------------- | ---- | ---------------------------- | ---------------------- |
|
| --------------------- | ---- | ---------------------------- | ---------------------- |
|
||||||
| session_list | 有会话时：array<br />无会话时：null | 会话列表 | 按发送时间顺序逆向排序 |
|
| session_list | 有会话时：array<br />无会话时：null | 会话列表 | 按发送时间顺序逆向排序 |
|
||||||
| has_more | num | 是否有更多会话 | |
|
| has_more | num | 是否有更多会话 | |
|
||||||
| anti_distrub_cleaning | bool | 是否开启“一键防骚扰”功能 | |
|
| anti_distrub_cleaning | bool | 是否开启了“一键防骚扰”功能 | |
|
||||||
| is_address_list_empty | num | （？） | **作用尚不明确** |
|
| is_address_list_empty | num | （？） | **作用尚不明确** |
|
||||||
| show_level | bool | 是否在会话列表中显示用户等级 | 目前恒为 `false` |
|
| show_level | bool | 是否在会话列表中显示用户等级 | 目前恒为 `false` |
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user