deploy and publish / build-and-deploy (push) Has been cancelled

Details

revert 7809924e2d

revert delete all

2026-01-29 09:03:04 +00:00

11 KiB

Raw Permalink Blame History

通知消息

获取未读消息数

https://api.bilibili.com/x/msgfeed/unread

https://api.vc.bilibili.com/x/im/web/msgfeed/unread (新接口)

请求方式：GET

认证方式：Cookie（SESSDATA）

本接口不会返回未读的私信数，要获取未读的私信数请参阅未读私信数相关说明

URL参数:

参数名	类型	内容	必要性	备注
build	num	客户端内部版本号	非必要	默认为 `0`
mobi_app	str	平台标识	非必要	可为 `web` 等

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data 对象：

字段	类型	内容	备注
at	num	未读at数（旧）
chat	num	0	仅旧接口，作用尚不明确
coin	num	未读投币数
danmu	num	未读弹幕数
favorite	num	未读收藏数
like	num	未读点赞数（旧）
recv_like	num	未读收到喜欢数（新）	同 `like`
recv_reply	num	未读回复与@数（新）	即 `reply` 与 `at` 的值之和
reply	num	未读回复数（旧）
sys_msg	num	未读系统通知数
sys_msg_style	num	1	仅新接口, 作用尚不明确
up	num	未读UP主助手信息数

示例：

以下信息代表了未读点赞数为10，未读回复数为4，未读at消息数为3，未读系统通知数为2，未读UP主助手信息数为1

curl 'https://api.vc.bilibili.com/x/im/web/msgfeed/unread' \
  -b 'SESSDATA=xxx'

查看响应示例：

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "at": 3,
    "chat": 0,
    "coin": 0,
    "danmu": 0,
    "favorite": 0,
    "like": 10,
    "recv_like": 10,
    "recv_reply": 4,
    "reply": 4,
    "sys_msg": 2,
    "sys_msg_style": 1,
    "up": 1
  }
}

获取"回复我的"信息

https://api.bilibili.com/x/msgfeed/reply

请求方式：GET

认证方式：Cookie（SESSDATA）

URL参数:

参数名	类型	内容	必要性	备注
build	num	客户端内部版本号	非必要	默认为 `0`
mobi_app	str	平台标识	非必要	可为 `web` 等
id	num	起始 id	非必要	详情见返回
reply_time	num	起始时间	非必要	详情见返回
platform	str	平台标识	非必要	可为 `web` 等
web_location	str	暂时不知道是啥	非必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录
message	str	错误信息	默认为 0
ttl	num	1
data	obj	信息本体

data 对象：

字段	类型	内容	备注
cursor	obj	光标	下一次查询的指针
items	array	通知列表	数组，每个元素代表一条回复通知
last_view_at	num	unix 时间戳	上次查看的时间

cursor 对象：

字段	类型	内容	备注
is_end	bool	是否结束	`false` 表示还有更多数据
id	num	通知 id	最后（旧）一条通知的 id，用作下次查询的起始 id
time	num	unix 时间戳	最后一条通知的时间

items 数组中的对象（每条通知）：

字段	类型	内容	备注
id	num	通知 id
user	obj	回复者的用户信息
item	obj	通知详情
counts	num	通知计数	固定为 `1`，可能表示单条通知
is_multi	num	是否多回复	固定为 `0`，可能表示单条回复
reply_time	num	unix 时间戳	回复时间

user 对象（回复者信息）：

字段	类型	内容	备注
mid	num	用户 mid
fans	num	粉丝数	固定为 `0`，可能不返回实际数据
nickname	str	用户昵称
avatar	str	头像 URL
mid_link	str	用户主页链接	固定为空字符串
follow	bool	是否关注该用户	`false` 表示未关注

item 对象（通知详情）：

字段	类型	内容	备注
subject_id	num	主体 id
root_id	num	根评论 id	最顶层的评论 ID
source_id	num	源评论 id	直接回复的评论 ID
target_id	num	目标评论 id	被回复的评论 ID
type	str	通知类型	固定为 `"reply"`（回复类型）
business_id	num	业务类型 id	`1`=视频评论，`11`=动态评论
business	str	业务名称	`"评论"` 或 `"视频"`
title	str	通知标题	摘要文本
desc	str	描述	固定为空字符串
image	str	图片 URL	固定为空字符串
uri	str	跳转链接	web 端跳转链接
native_uri	str	客户端跳转链接	客户端专用跳转链接
detail_title	str	详细标题	固定为空字符串
root_reply_content	str	根评论内容	最顶层评论的文本内容
source_content	str	源评论内容	直接回复的评论内容
target_reply_content	str	目标评论内容	被回复的评论内容
at_details	array	@的用户列表	数组，每个元素是被@的用户对象
topic_details	array	话题详情	固定为空数组
hide_reply_button	bool	是否隐藏回复按钮
hide_like_button	bool	是否隐藏点赞按钮
like_state	num	点赞状态	`0`=未点赞
danmu	null	弹幕信息	固定为 `null`
message	str	消息内容	固定为空字符串

at_details 数组中的对象（被@的用户）：

字段	类型	内容	备注
mid	num	用户 mid
fans	num	粉丝数	固定为 `0`
nickname	str	用户昵称
avatar	str	头像 URL
mid_link	str	用户主页链接	固定为空字符串
follow	bool	是否关注该用户	`false` 表示未关注