Python könyvtár

A hamapi Python csomag letölti az eszközei előzményadatait (datalogs). Kiolvassa Ön helyett a sorokat, és minden méréshez egy értéklistát ad. Szabadon használhatja (MIT licenc).

Telepítés

pip install hamapi

Python 3.6 vagy újabb kell. A csomag a requests és a brotli csomagot is telepíti.

Példa

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: az alkalmazás Fiók oldaláról kapja. Lásd: REST API.
'e11:123': az eszköz sorozatszáma. Olvasási jogosultság kell az eszközhöz.
start, end: Unix idő másodpercben.
averaging_step: nem kötelező. A csomag minden ennyi másodperces lépéshez egy átlagértéket ad. 0 értékkel (alapértelmezés) az összes sort megkapja.

Az eredmény

A get_datalog_data egy szótárat ad vissza:

timestamp: az egyes értékek időpontja, Unix másodpercben.
Egy lista az eszköz minden méréséhez és minden kimenetéhez, kulcsként a mérési kóddal (például T). A kódok a Mérési szótárban vannak.

Minden lista azonos hosszúságú. Az averaging_step nélkül a listákban minden változás előtt van még egy pont, így a grafikon lépcsőket mutat.

Egyéb függvények

ham.get_user_devices(): a fiókja eszközei, ugyanazok az adatok, mint a get_user_devices.php esetében.

Megjegyzések

A csomag a letöltött múltbeli napokat a .cached.db fájlban tárolja, az aktuális mappában. Ezeket a napokat nem tölti le újra. Az újbóli letöltéshez törölje a fájlt.
A csomag csak az előzményeket olvassa. Élő adatokhoz használja a WebSocketet.
A csomag a saját verziójának eszközdefinícióit tartalmazza. Új eszköztípusokhoz frissítse ezzel: pip install -U hamapi.
A csomag oldala: pypi.org/project/hamapi.

Lásd még

Csevegés az ügyfélszolgálattal