Przejdź do treści

Format danych

Format danych zbiorczych jest używany z webhook i mqtt jeśli wybrano Tryb zbiorczy.

v0.2.0

{
  "version": "0.2.0",
  "payload": {
    "timestamp": "2024-09-12T15:06:23+02:00",
    "readouts": {
      "electricity": [
        {
          "uuid": "RDNP3kXyncj8YIt2wS7G8",
          "what": "active",
          "timestamp": "2024-09-12T15:06:23+02:00",
          "value": 1.23
        }
      ],
      "gas": [
        {
          "uuid": "8YIt2wS7G8RDNP3kXyncj",
          "timestamp": "2024-09-12T15:07:23+02:00",
          "value": 2.34
        }
      ],
      "water": [
        {
          "uuid": "Xyncj8YIt2wS7G8RDNP3k",
          "timestamp": "2024-09-12T15:08:23+02:00",
          "value": 3.45
        }
      ],
      "heat": [
        {
          "uuid": "t2wS7G8RDNP3kXyncj8YI",
          "timestamp": "2024-09-12T15:09:23+02:00",
          "value": 4.56
        }
      ]
    }
  }
}

Przy każdym zaplanowanym lub ręcznym odczycie wszystkie odczyty będą wysłane z wybranym API, ale w celu zmniejszenia rozmiaru mogą być podzielone na wiele komunikatów.

pola

Pole Opis
version Wersja struktury danych, używana do określenia sposobu interpretacji payload.
payload.timestamp Czas utworzenia pakietu. Wiele komunikatów z tym samym głównym znacznikiem czasu można traktować jako jeden (po połączeniu).
payload.readouts Zawiera odczyty z różnych nośników. payload.readouts.electricity to tablice zawierające zero lub więcej odczytów.
Liczba odczytów w tablicy zależy od podziału pakietu na mniejsze części.
payload.readouts.<medium>.uuid Jest to nanoid.
payload.readouts.<medium>.timestamp Czas wykonania odczytu.
payload.readouts.<medium>.value Wartość zmiennoprzecinkowa.
payload.readouts.electricity.what active lub reactive.