Python-kirjasto

Python-paketti hamapi lataa laitteidesi historiatiedot (datalogit). Se lukee rivit puolestasi ja antaa yhden arvoluettelon kutakin mittausta kohti. Voit käyttää sitä vapaasti (MIT-lisenssi).

Asenna

pip install hamapi

Tarvitset Python 3.6:n tai uudemman. Paketti asentaa myös paketit requests ja brotli.

Esimerkki

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: saat sen sovelluksen sivulta Tili. Katso REST API.
'e11:123': laitteen sarjanumero. Tarvitset laitteen lukuoikeuden.
start, end: Unix-aika sekunteina.
averaging_step: valinnainen. Paketti antaa yhden keskiarvon jokaista näin monen sekunnin jaksoa kohti. Arvolla 0 (oletus) saat kaikki rivit.

Tulos

get_datalog_data palauttaa sanakirjan:

timestamp: kunkin arvon aika Unix-sekunteina.
Yksi luettelo kutakin laitteen mittausta ja lähtöä kohti, avaimena mittauskoodi (esimerkiksi T). Koodit ovat Mittaussanakirjassa.

Kaikki luettelot ovat yhtä pitkiä. Ilman parametria averaging_step luetteloissa on yksi piste lisää juuri ennen jokaista muutosta, jotta kuvaaja näyttää portaat.

Muut funktiot

ham.get_user_devices(): tilisi laitteet, samat tiedot kuin get_user_devices.php.

Huomautukset

Paketti säilyttää ladatut menneet päivät tiedostossa .cached.db nykyisessä kansiossa. Se ei lataa näitä päiviä uudelleen. Kun haluat ladata ne uudelleen, poista tiedosto.
Paketti lukee vain historian. Reaaliaikaisiin tietoihin käytä WebSocketia.
Paketissa ovat sen version laitemääritykset. Uusia laitetyyppejä varten päivitä se komennolla pip install -U hamapi.
Paketin sivu: pypi.org/project/hamapi.

Katso myös

Chat tuen kanssa