MINARA

列出通知

GET /v1/notifications:获取最近的应用内通知和 `unread_count`。

GET /v1/notifications

获取最近的应用内通知,按最新优先排序,并包含 unread_count。每当一个自定义智能体自行触发(定时、事件或一次性),且其应用内配置选择接收结果时,都会记录一条通知。可选参数 ?limit=,默认值为 50,最大值为 200。

桌面端还包含本地会话事件和当前登录账号的服务器通知。server_owner 是不透明的账号范围标识,退出登录时为 null,未启用桌面接收层时不返回。服务器记录带有 source: server,可包含 tag,标题和正文由服务器生成。Accept-Language 和 X-Minara-Client-Version 只更新当前安装的订阅信息。服务器通知的已读和删除操作只影响当前账号;清空列表会保留投递去重记录。服务器收件箱变化时,notifications WebSocket 通道发送 data 为空对象的 notifications_changed,客户端应重新请求此接口同步。

PC 的 presentation 独立指定 system(false、always、unfocused-only)、inbox(布尔值)和 toast(false、focused-only)。只有 inbox 记录计入未读数。server_deliveries 包含本次 gateway 运行期间收到的实时展示消息,可包含不进入铃铛的记录;historical 历史记录和冷启动收件箱不能补弹系统通知或 Toast。未知内部落地页回退首页。普通 Chat/Coding 完成和等待输入只在失焦时发系统通知。

方法GET
路径/v1/notifications
认证设置 GATEWAY_AUTH_TOKEN 时需要 Authorization: Bearer <token>
类别notifications

本页目录