|
|
@@ -1,23 +1,21 @@
|
|
|
# 后台首页第三方游戏商户余额
|
|
|
|
|
|
-首页新增「第三方游戏商户余额」卡片，显示公司商户当前余额，独立于首页日期筛选。
|
|
|
+余额为公司第三方游戏商户账户的最近一次有效余额，与首页日期筛选无关。
|
|
|
|
|
|
-## 初次读取
|
|
|
+## HTTP
|
|
|
|
|
|
-沿用后台登录态，进入首页时请求 `GET /admin/home/third-game-balance`，直接读取 `data`。
|
|
|
+`GET /admin/home/third-game-balance` 使用后台登录鉴权，无请求参数。
|
|
|
|
|
|
```json
|
|
|
{"code":0,"data":{"balance":"1234.5600000000","currency":"CNY","stale":false}}
|
|
|
```
|
|
|
|
|
|
-| 字段 | 展示规则 |
|
|
|
-|---|---|
|
|
|
-| `balance` | 金额字符串。`null` 显示「—」，金额为零时显示 `0` |
|
|
|
-| `currency` | 币种，例如 `CNY` |
|
|
|
-| `stale` | `true` 时保留金额并显示「暂未刷新，显示上次余额」 |
|
|
|
+| 字段 | 类型 | 含义 |
|
|
|
+|---|---|---|
|
|
|
+| `balance` | `string` 或 `null` | 最近一次查询成功的金额，尚无成功记录时为 `null` |
|
|
|
+| `currency` | `string` | 币种，例如 `CNY` |
|
|
|
+| `stale` | `boolean` | 有历史金额且最近一次余额刷新失败，或距上次成功已满 120 秒时为 `true`。尚无成功记录时为 `false` |
|
|
|
|
|
|
-## 实时更新
|
|
|
+## WebSocket
|
|
|
|
|
|
-订阅私有频道 `admin.stats.third_game_balance`，监听 `stats.updated`（直接用 Echo 时为 `.stats.updated`）。用 `event.data` 替换余额数据，字段与 HTTP `data` 相同。
|
|
|
-
|
|
|
-余额或失效状态变化时才推送。需重新同步时调用同一 GET，WebSocket 不可用时每 60 秒回读一次。离开首页时取消订阅和定时器。
|
|
|
+私有频道为 `admin.stats.third_game_balance`，事件名为 `stats.updated`。事件 `data` 与 HTTP 响应的 `data` 字段相同，数据变化时推送。
|
doge