文档

观察者接口

依据当前 Rust 工程 655097d2a5 的 PoolNode 路由、控制器、DTO 和鉴权中间件核对（2026-11-02）。上游返回字段不在本地 Rust 中定义的，以下仅列已确认的请求契约，不把历史示例作为固定响应结构。

POST /api/subaccount/observer 需要用户 JWT。JSON：sid（u64，必填），action（u8，必填）。当前矿池前端使用：0 创建、1 删除、2 查询。返回 data 为上游结果，前端将成功结果作为观察者 Token。

{"sid":149,"action":2}

GET /api/subaccount/info?coin=BTC 使用 RLOBTOKEN: Bearer OBSERVER_TOKEN，不能仅用用户 JWT 替代。coin 可选，默认 BTC。先读取观察者子账号信息，再用对应的子账号 ID 查询统计。

以下查询接受观察者请求头。观察者模式用于子账号查询，不应用于写入操作；不要将“路径允许观察者 Token”等同于本地已校验任意 sid 的归属，最终数据权限仍由上游控制。