Telemetrie
VeřejnéTyp obsahu: Reference
Historie měřených hodnot jako act-power nebo session-energy — automatická agregace podle délky období, limit 10 000 záznamů a uchování dat 90 dní.
Získání historických telemetrických dat ze zařízení
Endpointy
Telemetrie zařízení
GET /admin-panel/v1/external/history/telemetry/{deviceId}/{telemetryId}Telemetrie konkrétního modulu (node)
GET /admin-panel/v1/external/history/telemetry/{deviceId}/{nodeId}/{telemetryId}GET
/external/history/telemetry/{deviceId}/{telemetryId}Získat historická telemetrická data
Získejte historii telemetrických dat z vašeho zařízení. Vhodné pro vytváření grafů, analýz a reportů o spotřebě energie.
Autentizace
Parametry
Příklady kódu
curl -X GET "https://cloud.mybox.pro/admin-panel/v1/external/history/telemetry/{deviceId}/{telemetryId}" \
-u "YOUR_API_KEY:YOUR_API_SECRET" \
-H "Accept: application/json"Příklad odpovědi
{
"status": 1,
"data": [
{
"timestamp": "2025-01-15 14:30:00",
"value": 7280.5,
"unit": "W"
},
{
"timestamp": "2025-01-15 14:31:00",
"value": 7285.2,
"unit": "W"
},
{
"timestamp": "2025-01-15 14:32:00",
"value": 7290.8,
"unit": "W"
}
]
}Dostupné telemetrické hodnoty
Elektrické hodnoty
| ID telemetrie | Jednotka | Popis | Modul |
|---|---|---|---|
act-power | W | Aktuální výkon | evse |
voltage-l1 | V | Napětí fáze L1 | evse |
voltage-l2 | V | Napětí fáze L2 | evse |
voltage-l3 | V | Napětí fáze L3 | evse |
current-l1 | A | Proud fáze L1 | evse |
current-l2 | A | Proud fáze L2 | evse |
current-l3 | A | Proud fáze L3 | evse |
Nabíjecí relace
| ID telemetrie | Jednotka | Popis | Modul |
|---|---|---|---|
session-time | s | Délka nabíjecí relace | evse |
session-energy | kWh | Energie v aktuální relaci | evse |
total-energy | kWh | Celková dodaná energie | evse |
Síť a konektivita
| ID telemetrie | Jednotka | Popis | Modul |
|---|---|---|---|
signal | % | Síla WiFi signálu | device |
wifi-sta-rssi | dBm | RSSI WiFi | wifi |
Struktura odpovědi
{
"status": 1,
"data": [
{
"timestamp": "2024-01-15 14:30:00",
"value": 7280.5,
"unit": "W"
},
{
"timestamp": "2024-01-15 14:31:00",
"value": 7285.2,
"unit": "W"
}
]
}Praktické použití
Získání historie výkonu za posledních 24 hodin
import requests
from datetime import datetime, timedelta
# Časové rozmezí
date_to = datetime.now()
date_from = date_to - timedelta(hours=24)
# API volání
params = {
'dateFrom': date_from.strftime('%Y-%m-%d %H:%M:%S'),
'dateTo': date_to.strftime('%Y-%m-%d %H:%M:%S')
}
response = requests.get(
f"{BASE_URL}/external/history/telemetry/{device_id}/evse/act-power",
auth=HTTPBasicAuth(API_KEY, API_SECRET),
params=params
)
data = response.json()['data']Vytvoření grafu spotřeby
// Získání dat
const telemetryData = await fetchTelemetryHistory(deviceId, 'session-energy');
// Příprava pro graf
const chartData = telemetryData.map(point => ({
x: new Date(point.timestamp),
y: parseFloat(point.value)
}));
// Vykreslení pomocí Chart.js
new Chart(ctx, {
type: 'line',
data: {
datasets: [{
label: 'Spotřeba (kWh)',
data: chartData
}]
}
});Agregace dat
Pro dlouhé časové období API automaticky agreguje data:
| Období | Interval dat |
|---|---|
| < 1 den | Každá minuta |
| 1-7 dní | Každých 5 minut |
| 7-30 dní | Každých 15 minut |
| > 30 dní | Každou hodinu |
Limity a omezení
- Maximálně 10 000 záznamů na jeden požadavek
- Data jsou uchovávána 90 dní
- Pro starší data kontaktujte podporu
Doporučené use cases
- Monitoring spotřeby - Sledování denní/měsíční spotřeby
- Detekce anomálií - Identifikace neobvyklých hodnot
- Reporty - Generování přehledů pro fakturaci
- Optimalizace - Analýza nabíjecích vzorců
Související endpointy
- Live Data - Aktuální hodnoty
- Snapshot - Kompletní stav
- Charging Reports - Přehledy nabíjení