浮动

docs/前端接口/APP配置/落地页下载地址-前台接入.md

@@ -0,0 +1,26 @@
+# 落地页：苹果、安卓下载地址
+
+`GET /api/app_config/downloadLinks`
+
+使用前台 API 域名，无需登录、无需参数，一次获取两个下载地址。
+
+```json
+{
+  "code": 1,
+  "show": 0,
+  "msg": "",
+  "data": {
+    "ios_url": "https://apps.apple.com/app/id123456789",
+    "android_url": "https://download.example.com/app.apk"
+  }
+}
+```
+
+| 字段 | 使用方式 |
+| --- | --- |
+| `data.ios_url` | 苹果下载按钮的跳转地址 |
+| `data.android_url` | 安卓下载按钮的跳转地址 |
+
+地址来自后台「APP配置 → 安装包设置」，各平台使用最新新增且启用的安装包。关闭该平台的前台显示、没有启用的安装包时，地址返回 `""`，隐藏对应按钮。
+
+页面加载时请求，按钮直接使用返回的地址。`code=0` 时显示 `msg`。

docs/前端接口/落地页浮动数字-WebSocket接入.md

@@ -0,0 +1,11 @@
+# 落地页浮动数字
+
+复用现有 WebSocket 地址，无需登录、无需发送订阅消息。监听 `type=floating_number`：
+
+```json
+{"type":"floating_number","data":{"value":"1000000000.00"}}
+```
+
+连接成功立即收到当前值，之后每 5 秒更新一次。数字在 9.9 亿至 10.1 亿之间上下浮动，各客户端收到同一数值。
+
+`data.value` 是固定两位小数的字符串，直接用于展示。断线后按现有方式重连，即可收到最新值；保留原有心跳。