2023-02-22 01:00:06 +08:00
|
|
|
|
# 通知消息
|
|
|
|
|
|
|
|
|
|
|
|
## 未读消息数
|
|
|
|
|
|
|
|
|
|
|
|
> https://api.bilibili.com/x/msgfeed/unread
|
2024-07-20 18:38:49 +08:00
|
|
|
|
> https://api.vc.bilibili.com/x/im/web/msgfeed/unread (新接口)
|
2023-02-22 01:00:06 +08:00
|
|
|
|
|
|
|
|
|
|
*请求方式：GET*
|
|
|
|
|
|
|
|
|
|
|
|
认证方式：Cookie（SESSDATA）
|
|
|
|
|
|
|
2024-07-20 18:38:49 +08:00
|
|
|
|
**URL参数:**
|
|
|
|
|
|
|
|
|
|
|
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
|
|
|
|
|
| -------- | ---- | ---- | ------ | -------------------------- |
|
|
|
|
|
|
| build | num | 0 | 不必要 | 从新接口发现, 作用尚不明确 |
|
|
|
|
|
|
| mobi_app | str | web | 不必要 | 从新接口发现, 作用尚不明确 |
|
|
|
|
|
|
|
2023-02-22 01:00:06 +08:00
|
|
|
|
**json回复：**
|
|
|
|
|
|
|
|
|
|
|
|
根对象：
|
|
|
|
|
|
|
|
|
|
|
|
| 字段 | 类型 | 内容 | 备注 |
|
|
|
|
|
|
| ------- | ---- | -------- | ----------------------------- |
|
|
|
|
|
|
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
|
|
|
|
|
|
| message | str | 错误信息 | 默认为0 |
|
|
|
|
|
|
| ttl | num | 1 | |
|
|
|
|
|
|
| data | obj | 信息本体 | |
|
|
|
|
|
|
|
2024-07-20 18:38:49 +08:00
|
|
|
|
`data` 对象：
|
2023-02-22 01:00:06 +08:00
|
|
|
|
|
2024-07-20 18:38:49 +08:00
|
|
|
|
| 字段 | 类型 | 内容 | 备注 |
|
|
|
|
|
|
| ------------- | ---- | -------------- | ---------------------- |
|
|
|
|
|
|
| at | num | 未读at数 | |
|
|
|
|
|
|
| chat | num | 0 | 作用尚不明确 |
|
|
|
|
|
|
| coin | num | 未读投币数 | |
|
|
|
|
|
|
| danmu | num | 未读弹幕数 | |
|
|
|
|
|
|
| favorite | num | 未读收藏数? | |
|
|
|
|
|
|
| like | num | 未读点赞数 | |
|
|
|
|
|
|
| recv_like | num | 未读点赞数 | |
|
|
|
|
|
|
| recv_reply | num | 未读回复数 | |
|
|
|
|
|
|
| reply | num | 未读回复数 | |
|
|
|
|
|
|
| sys_msg | num | 未读系统通知数 | |
|
|
|
|
|
|
| sys_msg_style | num | 1 | 仅新接口, 作用尚不明确 |
|
|
|
|
|
|
| up | num | UP主助手信息数 | |
|
2023-02-22 01:00:06 +08:00
|
|
|
|
|
|
|
|
|
|
**示例：**
|
|
|
|
|
|
|
|
|
|
|
|
以下信息代表了未读点赞数为10，未读回复数为4，未读at消息数为3，未读系统通知数为2，UP主助手信息数为1
|
|
|
|
|
|
|
|
|
|
|
|
```shell
|
2024-07-20 18:38:49 +08:00
|
|
|
|
curl 'https://api.vc.bilibili.com/x/im/web/msgfeed/unread' \
|
2023-02-22 01:00:06 +08:00
|
|
|
|
-b 'SESSDATA=xxx'
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
<details>
|
|
|
|
|
|
<summary>查看响应示例：</summary>
|
|
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
|
{
|
|
|
|
|
|
"code": 0,
|
|
|
|
|
|
"message": "0",
|
|
|
|
|
|
"ttl": 1,
|
|
|
|
|
|
"data": {
|
|
|
|
|
|
"at": 3,
|
|
|
|
|
|
"chat": 0,
|
2024-07-20 18:38:49 +08:00
|
|
|
|
"coin": 0,
|
|
|
|
|
|
"danmu": 0,
|
|
|
|
|
|
"favorite": 0,
|
2023-02-22 01:00:06 +08:00
|
|
|
|
"like": 10,
|
2024-07-20 18:38:49 +08:00
|
|
|
|
"recv_like": 10,
|
|
|
|
|
|
"recv_reply": 4,
|
2023-02-22 01:00:06 +08:00
|
|
|
|
"reply": 4,
|
|
|
|
|
|
"sys_msg": 2,
|
2024-07-20 18:38:49 +08:00
|
|
|
|
"sys_msg_style": 1,
|
2023-02-22 01:00:06 +08:00
|
|
|
|
"up": 1
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
</details>
|
