API dokumentácia

Prihlásenie e-mailom a heslom. Vráti JWT token.

{
  "email": "your@email.com",
  "password": "yourPassword"
}

{
  "token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ1c2VyQGV4YW1...",
  "user": {
    "id": 42,
    "login": "your@email.com",
    "name": "Novak Jan",
    "role": "ROLE_USER",
    "avatar": "base64encodedImage..."
  }
}

{ "message": "invalidEmailOrPassword" }
// alebo / or: "disabledLoginFromWeb"

Zaregistruje novú UPS na serveri. Firmware volá tento endpoint pri prvom štarte alebo po továrenskom resete. Server automaticky zachytí IP adresu zariadenia.

{
  "sn":           "PSX-2024-001234",  // sériové číslo / serial number
  "type":         "PWX-12-4422",     // model (musí existovať na serveri)
  "comFirmware":  "v3.2.1",          // firmware ESP32 (komunikačný modul)
  "mainFirmware": "v2.1.0",          // firmware STM32 (hlavný kontrolér)
  "comUptime":    "2d 14h 33m",      // uptime ESP32
  "mainUptime":   "5d 02h 11m",      // uptime STM32
  "cpuLoad":      12,                // zaťaženie CPU v %
  "totalRamSize": 327680,           // celková heap pamäť (bytes)
  "freeRamSize":  218340,           // voľná heap pamäť (bytes)
  "info":         ""                 // voliteľný doplňujúci text
}

Odošle kompletný stav zariadenia na server. Firmware volá periodicky (predvolene každých 5 minút).

{
  "config": {
    "settings": {
      "dhcp": 1, "ip": "192.168.1.100", "netmask": "255.255.255.0",
      "gateway": "192.168.1.1", "dns": "8.8.8.8",
      "ntpServer": "pool.ntp.org", "timezone": "CET-1CEST,M3.5.0,M10.5.0/3",
      "forcePowerFromBatteries": 0,
      "remoteServer": { "serverUrl": "https://view.powersentrix.com", "companyId": "abc123", "upsId": "ups-01" }
    },
    "outputs": [
      { "id": 0, "description": "Router", "status": "ON", "voltage": 4810 },
      // ... celkom 12 výstupov (id 0–11) / 12 outputs total (id 0–11)
    ],
    "extraActions": [
      { "id": "0", "event": 1, "baseStatus": 0, "action": 1 }
    ],
    "ident": { /* Ident objekt — rovnaký ako pri setNewUps */ }
  },
  "upsData": {
    "voltages": [4810, 4805, 2410, 2408, 1205, 1202, 502, 501, 0, 0, 0, 0],
    // napätia v mV×10 (napr. 4810 = 48.10 V) / voltages in mV×10 (e.g. 4810 = 48.10 V)
    "currents": [150, 320, 200, 0, 0, 0, 0, 0, 0, 0, 0, 0],
    // prúdy v mA (napr. 150 = 1.50 A) / currents in mA (e.g. 150 = 1.50 A)
    "outputs": [1, 1, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0],
    // 1 = ZAP/ON, 0 = VYP/OFF
    "ventilation": 0,
    "uptime": "5d 02h 11m",
    "temps": { "board": 42, "mcu": 51 },
    // teploty v °C (integer) / temperatures in °C
    "ps": [
      {
        "main": 5410, "load": 4810, "batt": 5220, "buv": 4800,
        "cell": [1305, 1308, 1302, 1305],
        "status": { "h": { "hb": [1], "lb": [0] }, "l": { "hb": [0], "lb": [1] } }
      }
      // druhý PSU má rovnakú štruktúru / second PSU has the same structure
    ]
  }
}

Odošle jeden záznam udalosti (zmena stavu výstupu, alarm, výpadok napájania…).

{
  "ord":         1234,                        // sekvenčné číslo záznamu
  "code":        "I/E01",                     // kód udalosti
  "cmm":         "ups-01",                    // identifikátor UPS
  "description": "Output 1 turned ON",       // popis udalosti
  "params":      "",                          // voliteľné parametre
  "timestamp":   "2026-05-08 14:32:01"        // formát: yyyy-MM-dd HH:mm:ss
}

Vráti kompletný stavový objekt UPS — live dáta, konfiguráciu, výstupy, teploty, napájacie zdroje. Rovnaká štruktúra ako telo setUpsData.

{ "responseMessage": "OK", "responseObject": { /* UpsComplexObject */ } }

Vráti záznamy udalostí pre UPS zariadenie. Podporuje stránkovanie.

[
  {
    "id": 9901,
    "upsId": "42",
    "cmm": "ups-01",
    "code": "I/E01",
    "description": "Output 1 turned ON",
    "params": "",
    "timestamp": "2026-05-08T14:32:01"
  }, // ...
]

Základné informácie o UPS — meno, model, firmware, uptime, teploata, lokalita.

{
  "name": "Server Room UPS",   "ip": "192.168.1.100",
  "model": "PWX-12-4422",       "serialNumber": "PSX-2024-001234",
  "comFirmware": "v3.2.1",    "mainFirmware": "v2.1.0",
  "comUptime": "2d 14h 33m",  "mainUptime": "5d 02h 11m",
  "onOffLine": "online",       "temperature": 42,
  "description": "...",        "location": "Rack A",
  "company": "Acme Corp",     "cmm": "ups-01",
  "timestamp": "2026-05-08T14:30:00.000+0000"
}

Zoznam UPS zariadení prístupných prihlásenému používateľovi.

{ "responseMessage": "OK", "responseObject": [ /* pole Ups objektov */ ] }

Prepne stav výstupného portu (ZAP→VYP alebo VYP→ZAP). Server zavolá UPS cez GET /api_actions?fn=3&param1={port} na uloženom IP.

GET /ups/changePortState?id=42&port=0
Authorization: Bearer eyJhbGci...

// server potom zavolá:
GET http://192.168.1.100/api_actions?apiKey=mykey&fn=3&param1=0