RustMinerSystem

Документация

Read-only API Observer

Включение Observer, TOKEN, валюты, workers, графики и read-only endpoints логов RustMinerSystem.

Read-only API Observer

Режим Observer позволяет искать workers по wallet или subaccount без входа в административную панель. Он использует отдельный token и предоставляет только read-only операции, реализованные frontend Observer.

Управление Observer

Метод Путь Назначение
GET /api/ob Получить состояние и token Observer.
POST /api/ob/{flag} Включить или отключить Observer; flag равен 1 или 0.

Внешний client использует общий custom API header для обоих management calls и не выполняет вход. Frontend читает:

{
  "ob": 1,
  "token": "<Observer token>"
}

Авторизация Observer

Публичная страница не отправляет backend Authorization. Она использует:

X-OB-TOKEN: <Observer token>

Frontend может получить token из query token или ob и сохранить в local storage браузера. Сторонним приложениям безопаснее получать его из защищенной конфигурации и передавать только в header.

Доступные endpoints

Метод Путь Назначение
GET /api/currency/config Получить доступные валюты.
GET /api/d/{coin}/g/workers Найти workers по coin и wallet/subaccount.
GET /api/stat/worker/{id} График хешрейта worker.
GET /api/group/{gid}/log Логи подключений worker.
GET /api/worker/{id}/error/log Failure data stream worker.

Запрос workers

GET /api/d/BTC/g/workers?device=0&size=50&page=1&col=s_thh&desc=1&wallet=wallet-name
X-OB-TOKEN: <Observer token>
Параметр Значение
coin URL-encoded код валюты backend.
wallet Wallet/subaccount; несколько значений через запятую.
device Фильтр состояния.
size / page Pagination.
col / desc Поле и направление сортировки.

Ответ соответствует обычному списку workers и содержит workers, total и stat.

Граница безопасности

  • При утечке token отключите и снова включите Observer для rotation.
  • Передавайте Observer link только доверенным пользователям.
  • Reverse proxy должен пропускать X-OB-TOKEN, но скрывать его из access logs.
  • Observer token не является backend TOKEN и не может изменять ports или wallets.