Как программно мониторить майнеры через API NoxHash

Почему стоит мониторить майнеры через API, а не через дашборд

Веб-дашборд NoxHash создан для людей: вы логинитесь, бросаете взгляд на hashrate и баланс BTC, и выходите. Это работает для одного-двух майнеров. Как только вы управляете несколькими арендами — или хотите получать оповещения, когда что-то ломается в 3 часа ночи — вам нужна машина, которая будет наблюдать за вами.

API-монитор живёт вне дашборда и получает те же данные по расписанию. Он может писать доход в таблицу, отправлять метрики в Grafana или присылать SMS в момент, когда майнер ушёл в offline. Логика принадлежит вам, поэтому именно вы решаете, когда получать уведомления и что считать «проблемой».

Шаг 1 — Создайте API-ключ в своём аккаунте NoxHash

Каждый вызов API требует аутентифицированной личности. NoxHash выдаёт персональные API-ключи в настройках аккаунта, и вы можете задать дату истечения, чтобы утёкший ключ перестал работать автоматически.

Шаг 2 — Минимальный Python-монитор (псевдокод)

Вот маленький, читаемый Python-скрипт, который аутентифицируется, получает ваших майнеров и помечает тех, кто был offline больше 30 минут. Он намеренно прост — без зависимостей кроме requests — так что вы можете сегодня положить его в cron, а завтра укрепить.

import os, time, requests
from datetime import datetime, timedelta, timezone

API_BASE = "https://api.noxhash.com/v1"   # confirm in current docs
API_KEY  = os.environ["NOXHASH_API_KEY"]  # never hard-code
OFFLINE_THRESHOLD = timedelta(minutes=30)

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Accept": "application/json",
}

def fetch_miners():
    r = requests.get(f"{API_BASE}/miners", headers=headers, timeout=10)
    r.raise_for_status()
    return r.json().get("data", [])

def check_offline(miners):
    now = datetime.now(timezone.utc)
    alerts = []
    for m in miners:
        if m["status"] != "running":
            last_seen = datetime.fromisoformat(m["last_seen_at"])
            if now - last_seen > OFFLINE_THRESHOLD:
                alerts.append(m)
    return alerts

def send_sms(miner):
    # plug in Twilio / Vonage / a webhook to your phone
    print(f"ALERT: {miner['name']} offline since {miner['last_seen_at']}")

if __name__ == "__main__":
    while True:
        try:
            for miner in check_offline(fetch_miners()):
                send_sms(miner)
        except requests.HTTPError as e:
            print(f"API error: {e}")
        time.sleep(300)  # poll every 5 minutes — be kind to the API

Предпочитаете JavaScript? Та же форма работает с fetch в Node.js-скрипте, запускаемом через cron-runner или serverless-планировщик. Логика идентична: аутентификация, список майнеров, фильтрация по status и timestamp, уведомление.

const API_BASE = "https://api.noxhash.com/v1";
const API_KEY  = process.env.NOXHASH_API_KEY;
const OFFLINE_MS = 30 * 60 * 1000;

async function fetchMiners() {
  const res = await fetch(`${API_BASE}/miners`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const { data } = await res.json();
  return data;
}

function offlineAlerts(miners) {
  const now = Date.now();
  return miners.filter(m =>
    m.status !== "running" &&
    now - new Date(m.last_seen_at).getTime() > OFFLINE_MS
  );
}

setInterval(async () => {
  try {
    const alerts = offlineAlerts(await fetchMiners());
    alerts.forEach(m => console.log(`ALERT: ${m.name} offline`));
  } catch (e) { console.error(e.message); }
}, 5 * 60 * 1000);

Три сценария, с которых стоит начать

Не нужно строить всё в первый же день. Выберите один из этих вариантов и выкатите его в эти выходные — каждый достаточно мал для одного вечера и по-настоящему полезен уже в понедельник утром.

Polling или Webhook — что подходит вам?

Polling означает, что ваш скрипт спрашивает API «что нового?» по таймеру. Webhook переворачивает поток: NoxHash сам пушит события на URL, который вы хостите. У обоих есть своё место. Если API в данный момент поддерживает webhook для интересующих вас событий, они дешевле и быстрее; если нет — вежливый polling-цикл тоже отлично работает.

Гибрид часто оказывается правильным ответом: webhook для критичных оповещений (майнер offline, аренда близка к истечению), polling для периодических сводок (ежедневный лог дохода, еженедельный отчёт). Выбирайте, исходя из того, какие события API предоставляет, и насколько вы терпимы к задержке в 1–5 минут.

Этикет rate limit и гигиена ключей

API, которым вы злоупотребляете, — это API, который вы теряете. NoxHash, как и любая серьёзная платформа, применяет rate limit и может временно блокировать плохо ведущие себя ключи. Несколько привычек помогут вашей интеграции оставаться желанной, а аккаунту — в безопасности.

Часто задаваемые вопросы