功能描述
此 API 端点 POST /api/notification/pushErrMsg
用于向思源笔记界面推送一条错误类型的通知消息。
这通常用于插件或外部应用需要向用户报告错误状态时使用,消息会以特定的错误样式(例如红色背景)显示。
请求参数
请求体必须是 JSON 格式,包含以下参数:
msg
(string): 必填,要推送的错误消息内容。timeout
(number): 可选,消息显示的超时时间(毫秒),默认为 7000ms (7秒)。
{
"msg": "无法连接到服务器,请检查网络连接。",
"timeout": 10000
}
响应结果
成功的请求将返回一个 JSON 对象,格式如下:
{
"code": 0,
"msg": "",
"data": {
"id": "unique-message-id" // 返回推送消息的唯一 ID
}
}
code
: 0 表示成功,非 0 表示失败。msg
: 错误信息(如果 code 非 0)。data.id
: 推送消息的唯一标识符。
注意: 消息是通过 WebSocket 广播给所有连接的界面的。
在线测试
您可以在下方输入请求参数进行在线测试。