Pythoni teek

Pythoni pakett hamapi laadib alla teie seadmete ajaloolised andmed (andmelogid). See loeb read teie eest ja annab iga näidu jaoks ühe väärtuste loendi. Saate seda vabalt kasutada (MIT litsents).

Paigaldamine

pip install hamapi

Vajate Pythoni versiooni 3.6 või uuemat. Pakett paigaldab ka requests ja brotli.

Näide

import time
import hamapi

ham = hamapi.hamapi(api_key='YOUR_API_KEY')

end = int(time.time())
start = end - 7 * 86400

data = ham.get_datalog_data('e11:123', start, end, averaging_step=120)
print(list(data.keys()))
print(data['timestamp'][:5])

api_key: selle saate rakenduse lehelt Konto. Vaadake REST API.
'e11:123': seadme seerianumber. Vajate seadmele lugemisõigust.
start, end: Unixi aeg sekundites.
averaging_step: valikuline. Pakett annab ühe keskmise väärtuse iga nii mitme sekundi pikkuse sammu kohta. Väärtusega 0 (vaikimisi) saate kõik read.

Tulemus

get_datalog_data tagastab sõnastiku:

timestamp: iga väärtuse aeg Unixi sekundites.
Üks loend seadme iga näidu ja iga väljundi jaoks, võtmeks näidu kood (näiteks T). Koodid on lehel Näitude sõnastik.

Kõik loendid on sama pikkusega. Ilma averaging_step-ita on loendites enne iga muutust üks punkt rohkem, et graafik näitaks astmeid.

Muud funktsioonid

ham.get_user_devices(): teie konto seadmed, samad andmed nagu get_user_devices.php.

Märkused

Pakett hoiab allalaaditud möödunud päevi failis .cached.db praeguses kaustas. Neid päevi see uuesti alla ei laadi. Uuesti allalaadimiseks kustutage fail.
Pakett loeb ainult ajalugu. Reaalajas andmete jaoks kasutage WebSocketi.
Paketis on selle versiooni seadmete definitsioonid. Uute seadmetüüpide jaoks uuendage seda käsuga pip install -U hamapi.
Paketi leht: pypi.org/project/hamapi.

Vaadake ka

Vestle toega