🎨 提供消息提示推送 API 接口 https://github.com/siyuan-note/siyuan/issues/5102

API_zh_CN.md

@@ -34,11 +34,14 @@
     * [执行 SQL 查询](#执行-SQL-查询)
 * [模板](#模板)
     * [渲染模板](#渲染模板)
-* [导出](#导出)
-    * [导出 Markdown 文本](#导出-markdown-文本)
 * [文件](#文件)
     * [获取文件](#获取文件)
     * [写入文件](#写入文件)
+* [导出](#导出)
+    * [导出 Markdown 文本](#导出-markdown-文本)
+* [通知](#通知)
+    * [推送消息](#推送消息)
+    * [推送报错消息](#推送报错消息)
 * [系统](#系统)
     * [获取启动进度](#获取启动进度)
     * [获取系统版本](#获取系统版本)
@@ -799,7 +802,7 @@
 * 参数为 HTTP Multipart 表单
 
     * `path`：工作空间路径下的文件路径
-    * `isDir`：是否为创建文件夹，为 `true` 时仅创建文件夹，忽略 `file` 
+    * `isDir`：是否为创建文件夹，为 `true` 时仅创建文件夹，忽略 `file`
     * `modTime`：最近访问和修改时间，Unix time
     * `file`：上传的文件
 * 返回值
@@ -842,6 +845,58 @@
     * `hPath`：人类可读的路径
     * `content`：Markdown 内容
 
+## 通知
+
+### 推送消息
+
+* `/api/notification/pushMsg`
+* 参数
+
+  ```json
+  {
+    "msg": "test",
+    "timeout": 7000
+  }
+  ```
+    * `timeout`：消息持续显示时间，单位为毫秒。可以不传入该字段，默认为 7000 毫秒
+* 返回值
+
+  ```json
+  {
+    "code": 0,
+    "msg": "",
+    "data": {
+        "id": "62jtmqi"
+    }
+  }
+  ```
+    * `id`：消息 ID
+
+### 推送报错消息
+
+* `/api/notification/pushErrMsg`
+* 参数
+
+  ```json
+  {
+    "msg": "test",
+    "timeout": 7000
+  }
+  ```
+    * `timeout`：消息持续显示时间，单位为毫秒。可以不传入该字段，默认为 7000 毫秒
+* 返回值
+
+  ```json
+  {
+    "code": 0,
+    "msg": "",
+    "data": {
+        "id": "qc9znut"
+    }
+  }
+  ```
+    * `id`：消息 ID
+
 ## 系统
 
 ### 获取启动进度