Sækja söguleg gögn

Söguleg gögn hvers tækis eru í textaskrám (datalogs) á tækjaþjóni þess. Hver skrá nær yfir einn dag, einn mánuð eða alla söguna. Þú þarft lesheimild á tækinu.

Fyrir útflutning án kóða notarðu skýrslur appsins. Sjá Gögnin þín (geymsla, útflutningur, eyðing).

Aðferð

Finndu netþjón tækisins. Kallaðu á get_device_info.php og lestu reitinn device_server. Sjá REST API.
Finndu röð dálkanna. Kallaðu á get_device_definitions.php?family_id=<family> og lestu readings og output_names.
Reiknaðu stigið og skráarnúmerið (bin) fyrir tímabilið sem þú vilt.
Sæktu hverja skrá frá netþjóni tækisins.
Sameinaðu línurnar, raðaðu þeim eftir tímastimpli og fylltu í tómu reitina.

Beiðnin

curl --compressed \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  "https://DEVICE_SERVER/datalogs.php?serialno=e11:123&id=0.20740&ver=2"

Settu gildi reitsins device_server fyrir tækið í stað DEVICE_SERVER.

Færibreyta	Gildi
`serialno`	Raðnúmer tækisins
`id`	`<level>.<bin>`, til dæmis `0.20740`
`ver`	`2`

Fyrir auðkenningu sendirðu hausinn Authorization: Bearer-API YOUR_API_KEY eða Authorization: Bearer YOUR_ACCESS_TOKEN.

Netþjónninn getur sent skrána þjappaða (gzip eða br). Valkosturinn --compressed í curl afþjappar hana.

HTTP-kóði	Merking
200	Skráin, sem `text/plain`
400	Rangt `serialno` eða `id`
403	Þú hefur ekki lesheimild á tækinu
404	Það eru engin gögn fyrir þessa skrá

Stig og skráarnúmer

Allir útreikningar nota UTC.

Stig	Ein skrá fyrir hvern	Útreikningur bin	Dæmi
`0`	Dag	`floor(unix_seconds / 86400)`	14. október 2026 = `0.20740`
`1`	Mánuð	`(year - 1970) * 12 + (month - 1)`	Október 2026 = `1.681`
`2`	Alla söguna	Alltaf `m`	`2.m`

Stig 0 hefur allar línur dagsins. Stig 1 hefur um eina línu á dag. Stig 2 hefur um eina línu á mánuði.

Appið notar stig 0 fyrir tímabil allt að 7 dögum og stig 1 fyrir tímabil allt að 5 mánuðum. Fyrir lengri tímabil notar það 2.m.

Snið línanna

Hver lína er ein mæling. Reitirnir eru aðskildir með ;.

timestamp;reading1;reading2;...;readingN;output1;...;outputM

timestamp er Unix-sekúndur (UTC). Hann getur haft aukastafi.
Síðan koma mælingarnar, í röð readings fjölskyldunnar.
Síðan koma úttökin, í röð output_names.
Tómur reitur merkir að gildið breyttist ekki. Notaðu síðasta gildið úr fyrri línu.
Gildið 2147483648 merkir að mælinguna vantar.
Línurnar eru ekki alltaf í röð. Raðaðu þeim eftir timestamp.

Dæmi

Tæki í fjölskyldunni e11 hefur readings = ["T", "GI", "GIC", "GI2", "GI2C"] og engin úttök.

1791936198.977;2120;1;0;1;0

Reitur	Gildi	Merking
timestamp	`1791936198.977`	Tími mælingarinnar
`T`	`2120`	21,20 °C, því umreikningur `T` er `divide_by_100`
`GI`	`1`	Staða fyrsta inntaksins
`GIC`	`0`	Teljari fyrsta inntaksins
`GI2`	`1`	Staða annars inntaksins
`GI2C`	`0`	Teljari annars inntaksins

Þú finnur umreikningana og einingarnar í orðabókinni readings í skilgreiningunum. Sjá REST API.

Dæmi í skel

Þetta dæmi sækir síðustu 3 daga tækis.

SERVER=DEVICE_SERVER
SN=e11:123
TODAY=$(( $(date -u +%s) / 86400 ))
for BIN in $(seq $((TODAY - 2)) $TODAY); do
  curl -s --compressed \
    -H "Authorization: Bearer-API YOUR_API_KEY" \
    "https://$SERVER/datalogs.php?serialno=$SN&id=0.$BIN&ver=2"
done | sort -t';' -k1,1n

Önnur aðferð

MCP-netþjónninn hefur verkfærið get_device_history. Það tekur við sömu stigum og bin-gildum.

Spjall við þjónustuver