docs(api): 更新电池分页接口说明

2026-05-11 23:16:59 +08:00
parent c533113229
commit a8e3cf5f4b
2 changed files with 5 additions and 3 deletions
@@ -86,7 +86,8 @@ src/
 接口保持模板里的 ORPC 模式：

 - `battery.dashboard`：读取每个 `mac` 的最新记录并生成看板聚合数据
- `battery.batteries`：无 `mac` 时返回每台设备最新记录；带 `mac` 时返回该设备历史记录，按 `create_time desc` 限制 500 条
+- `battery.batteries`：分页返回每台设备最新记录，支持 `pageSize`、`cursor`、`search`、`lowPower`、`powerStatus`、`sort` 筛选/排序
+- `battery.history`：按 `mac` 返回该设备历史记录，按 `create_time desc` 限制 500 条

 所有业务查询都是 `SELECT`，没有 mutation，也没有 mock/fallback 数据。