文档

观察者只读 API

RustMinerSystem 观察者模式的启停、TOKEN、币种、矿工、图表和日志只读查询接口。

观察者模式允许用户按钱包或子账号查询矿工数据。它使用独立的观察者 TOKEN，只提供前端已实现的只读查询。

管理观察者模式

方法	路径	用途
GET	`/api/ob`	获取观察者状态和 TOKEN。
POST	`/api/ob/{flag}`	开启或关闭观察者模式；`flag` 为 `1` 或 `0`。

这两个管理接口由外部程序调用时使用通用的 X-ACCESS-TOKEN。GET /api/ob 的前端读取字段为：

{
  "ob": 1,
  "token": "<观察者 TOKEN>"
}

ob=1 表示启用，ob=0 表示关闭。token 是字符串，只在可信渠道传递。POST 设置成功返回成功标量或 HTTP 200；随后重新 GET 获取最终状态和 TOKEN。

公开页面发送独立的观察者请求头：

X-OB-TOKEN: <观察者 TOKEN>

新版前端可以从访问链接的 token 或 ob 查询参数读取 TOKEN，并保存到浏览器本地存储。为降低泄漏风险，第三方客户端应优先通过安全配置传入请求头，不要把 TOKEN 长期放在 URL 中。

GET /api/d/BTC/g/workers?device=0&size=50&page=1&col=s_thh&desc=1&wallet=wallet-name
X-OB-TOKEN: <观察者 TOKEN>

响应结构与后台端口矿工列表相同，包含 workers、stat、pages、total、page 和 size。workers[]、stat 以及 sid/gid 的完整字段见矿工列表返回模型。

字段依赖：

字段	来源
`{coin}`	`GET /api/currency/config`的对象键或条目 `name`。
`wallet`	用户提供的钱包/子账号；多个值以逗号拼接并进行 URL 编码。
图表 `{id}`	查询结果的 `workers[].sid
日志 `{gid}`	查询结果的 `workers[].gid`。
失败数据 `{id}`	查询结果的 `workers[].id

图表返回 ChartPoint[]，连接日志返回 { t, f, d? }[]，失败数据接口保持原始响应；详见日志与连接返回字段。