API Write

Az ADA P1 Meter nemcsak adatokat szolgáltat, hanem képes külső rendszerekből érkező adatokat is fogadni. Ezeket az értékeket automatikusan beépíti a JSON kimenetébe, és ha MQTT kapcsolaton keresztül adatokat továbbít, az API-n keresztül kapott adatok is bekerülnek a publikált üzenetekbe.

Ez a lehetőség számos egyedi integrációs és automatizálási megoldást tesz lehetővé.

Elérési útvonal

A POST típusú adatküldés az alábbi címen keresztül történik:

http://okosvillanyora.local:8989/write

Adatformátum

A POST kérések tartalma JSON formátumú legyen. A szerver a következő mezőket várja:

• device: az eszköz neve vagy azonosítója
• values: egy tömb objektumokkal, ahol minden objektum tartalmazza:
  • index: szám (egyedi azonosító)
  • name: tetszőleges címke (pl. "L1")
  • value: az érték számmal
  • unit: a mértékegység (pl. "kWh")

Példa CURL használata Windows alatt

curl -X POST "http://okosvillanyora.local:8989/write" \
  -H "Content-Type: application/json" \
  -d "{\"device\":\"Device1\",\"values\":[{\"index\":0,\"name\":\"L1\",\"value\":3.5,\"unit\":\"kWh\"},{\"index\":1,\"name\":\"L2\",\"value\":5.3,\"unit\":\"kWh\"}]}"

A válasz:

{"status":"success","message":"Data written successfully"}

Eredmény a JSON kimenetben

A sikeres adatküldés után a JSON válaszban megjelenik egy új kulcs: plugins, amely tartalmazza a beküldött értékeket.

"plugins": {
  "L1": {
    "value": "3.50",
    "unit": "kWh",
    "timestamp": "74437"
  },
  "L2": {
    "value": "5.30",
    "unit": "kWh",
    "timestamp": "74437"
  }
}

A timestamp automatikusan generálódik az eszköz aktuális rendszerideje alapján.

Felhasználási lehetőségek

• Saját eszközök (pl. hőmérők, időjárás szenzorok) adatainak hozzáfűzése a villanyóra adatokhoz
• Kiegészítő mérések (pl. szobai fogyasztás, külső teljesítmény)
• Felhasználói input (manuális értékek, tesztadatok)
• Automatizált rendszerekből érkező vezérlő jelzések logolása
• MQTT broker felé történő továbbítás elemzés vagy adattárolás céljából

Ezzel a funkcióval az ADA P1 Meter nemcsak egy olvasó eszköz, hanem egy bemeneti adatgyűjtő modulként is funkcionálhat, ami rugalmassá és skálázhatóvá teszi az energiafigyelő rendszeredet.