Docs

Live Data

VeřejnéTyp obsahu: Reference

Endpoint pro aktuální stav wallboxu — telemetrie, nody evse, wifi a status-control, stavy nabíjení, teploty a doporučené intervaly dotazování.

Získání real-time dat z vaší nabíjecí stanice

Endpoint

GET /admin-panel/v1/external/live/device/{deviceId}

Parametry

  • deviceId (string, povinný) - Identifikátor vašeho zařízení

Interaktivní API Explorer

GET/external/live/device/{deviceId}

Získat Live Data ze zařízení

Získejte aktuální real-time data z vaší nabíjecí stanice včetně telemetrie, senzorů a konfigurace. API automaticky načte seznam vašich zařízení.

Autentizace

Parametry

Příklady kódu

curl -X GET "https://cloud.mybox.pro/admin-panel/v1/external/live/device/{deviceId}" \
  -u "YOUR_API_KEY:YOUR_API_SECRET" \
  -H "Accept: application/json"

Příklad odpovědi

{
  "status": 1,
  "data": [
    {
      "owner": "8fecc345f3ce5304...",
      "device": {
        "id": "qfeb-od13-ul2c-sgrl",
        "name": "MyBox Home",
        "state": "ready",
        "localIp": "192.168.1.23",
        "mac": "7c-df-a1-f3-e1-ac",
        "firmwareVersion": "7",
        "telemetry": [
          {
            "id": "signal",
            "name": "WiFi Signal",
            "value": "84",
            "dataType": "integer",
            "unit": "%"
          },
          {
            "id": "ipw",
            "name": "IP WIFI",
            "value": "192.168.1.23",
            "dataType": "string"
          }
        ],
        "nodes": [
          {
            "id": "evse",
            "name": "EVSE",
            "state": "ready",
            "sensors": [
              {
                "id": "act-power",
                "name": "Active Power",
                "value": "0.00",
                "dataType": "float",
                "unit": "kW"
              },
              {
                "id": "session-energy",
                "name": "Session Energy",
                "value": "0.00",
                "dataType": "float",
                "unit": "kWh"
              }
            ]
          }
        ]
      }
    }
  ]
}

Důležité upozornění

API vrací pole objektů - může obsahovat více záznamů pro různé vlastníky nebo stavy zařízení. Aktuální data jsou obvykle v posledním záznamu s nejkompletněji vyplněnými hodnotami.

Struktura odpovědi

{
  "data": [
    {
      "owner": "hash_vlastníka",
      "device": {
        "id": "abc1-def2-ghi3-jkl4",
        "name": "MyBox Home",
        "state": "ready",
        "options": [...],
        "telemetry": [...],
        "nodes": [...]
      }
    }
  ]
}

Hlavní sekce dat

1. Základní informace o zařízení

{
  "id": "abc1-def2-ghi3-jkl4",
  "name": "MyBox Home",
  "firmwareName": "1682081987312165",
  "firmwareVersion": "7",
  "state": "ready",
  "localIp": "192.168.1.23",
  "mac": "7c-df-a1-f3-e1-ac",
  "implementation": "esp-idf"
}
PoleVýznam
stateAktuální stav (ready/disconnected)
localIpIP adresa v lokální síti
macMAC adresa zařízení

2. Options - Možnosti ovládání

"options": [
  {
    "id": "reboot",
    "name": "Reboot device",
    "value": "false",
    "dataType": "boolean",
    "settable": "true"
  },
  {
    "id": "ota-available",
    "name": "OTA available",
    "value": "false",
    "dataType": "boolean",
    "settable": "false"
  }
]

Důležité options:

  • reboot - Možnost restartovat zařízení
  • reboot-required - Zda je potřeba restart
  • ota-available - Dostupná aktualizace firmware

3. Telemetry - Základní telemetrie

"telemetry": [
  {
    "id": "signal",
    "name": "WiFi Signal",
    "value": "78",
    "dataType": "integer",
    "unit": "%"
  },
  {
    "id": "fw",
    "name": "Firmware",
    "value": "7",
    "dataType": "string"
  },
  {
    "id": "ipw",
    "name": "IP WIFI",
    "value": "192.168.1.23",
    "dataType": "string"
  }
]

Co najdete v telemetrii:

  • signal - Síla WiFi signálu (0-100%)
  • fw - Verze firmware
  • ipw - IP adresa přes WiFi
  • ipe - IP adresa přes Ethernet (pokud připojeno)

4. Nodes - Detailní data modulů

Každé zařízení má několik modulů (nodes), které obsahují senzory:

Status-control node

{
  "id": "status-control",
  "sensors": [
    {
      "id": "temp-evse",
      "value": "32.67",
      "unit": "#",
      "format": "-50:200"
    },
    {
      "id": "temp-chip",
      "value": "57.70",
      "unit": "#",
      "format": "-50:200"
    },
    {
      "id": "cloud-mqtt",
      "value": "true"
    }
  ]
}

Klíčové senzory:

  • temp-evse - Teplota nabíjecího modulu (°C)
  • temp-chip - Teplota procesoru (°C)
  • cloud-mqtt - Připojení ke cloudu
  • wifi-sta - Stav WiFi připojení

System node

{
  "id": "system",
  "sensors": [
    {
      "id": "system-uptime",
      "value": "1024:48:16"  // hodiny:minuty:sekundy
    },
    {
      "id": "system-heap",
      "value": "1910"  // volná paměť v KB
    }
  ]
}

WiFi node

{
  "id": "wifi",
  "sensors": [
    {
      "id": "wifi-sta-rssi",
      "value": "-61"  // síla signálu v dBm
    },
    {
      "id": "wifi-sta-ssid",
      "value": "MyHomeWiFi"
    }
  ]
}

EVSE (nabíjecí modul)

{
  "id": "evse",
  "sensors": [
    {
      "id": "state",
      "value": "3",  // 1=idle, 2=ready, 3=charging
      "name": "State"
    },
    {
      "id": "pp-state",
      "value": "1",  // proximity pilot
      "name": "PP State"
    },
    {
      "id": "lock-state",
      "value": "1",  // 0=unlocked, 1=locked
      "name": "Lock State"
    }
  ],
  "telemetry": [
    {
      "id": "act-power",
      "value": "7280",
      "unit": "W",
      "name": "Actual Power"
    },
    {
      "id": "voltage-l1",
      "value": "231.45",
      "unit": "V"
    },
    {
      "id": "current-l1",
      "value": "31.47",
      "unit": "A"
    }
  ]
}

Klíčové hodnoty pro monitoring

Stav nabíjení

SenzorUmístěníHodnoty
stateevse node1=idle, 2=ready, 3=charging
pp-stateevse nodeProximity pilot status
lock-stateevse node0=odemčeno, 1=zamčeno

Elektrické hodnoty

TelemetrieJednotkaPopis
act-powerWAktuální výkon
voltage-l1/l2/l3VNapětí na fázích
current-l1/l2/l3AProud na fázích
session-timesČas nabíjecí relace
session-energykWhNabito v aktuální relaci

Teploty

SenzorJednotkaBěžné hodnoty
temp-evse°C20-60°C
temp-chip°C30-70°C
temp-amb°Cokolní teplota

Praktické využití

Kontrola stavu nabíjení

// Získání stavu nabíjení
const evseNode = data[0].device.nodes.find(n => n.id === 'evse');
const state = evseNode.sensors.find(s => s.id === 'state');

switch(state.value) {
  case '1': console.log('Idle - čeká'); break;
  case '2': console.log('Ready - připojeno vozidlo'); break;
  case '3': console.log('Charging - nabíjí'); break;
}

Monitoring výkonu

// Získání aktuálního výkonu
const evseNode = data[0].device.nodes.find(n => n.id === 'evse');
const power = evseNode.telemetry.find(t => t.id === 'act-power');
console.log(`Aktuální výkon: ${power.value} W`);

Kontrola připojení

// Kontrola cloud připojení
const statusNode = data[0].device.nodes.find(n => n.id === 'status-control');
const cloudMqtt = statusNode.sensors.find(s => s.id === 'cloud-mqtt');
if (cloudMqtt.value === 'true') {
  console.log('Připojeno ke cloudu');
}

Doporučené intervaly obnovování

  • Při nabíjení: každých 10-30 sekund
  • V klidu: každých 60-300 sekund
  • Pro grafy: každých 30-60 sekund

Optimalizace

Pro snížení zátěže API používejte delší intervaly, když zařízení nenabíjí.

Související endpointy

On this page

Získání real-time dat z vaší nabíjecí stanice EndpointParametry Interaktivní API Explorer Důležité upozornění Struktura odpovědi Hlavní sekce dat1. Základní informace o zařízení2. Options - Možnosti ovládání3. Telemetry - Základní telemetrie4. Nodes - Detailní data modulů Status-control node System node WiFi node EVSE (nabíjecí modul) Klíčové hodnoty pro monitoring Stav nabíjení Elektrické hodnoty Teploty Praktické využitíKontrola stavu nabíjeníMonitoring výkonuKontrola připojení Doporučené intervaly obnovování Související endpointy

Stáhnout