Python biblioteka

Python paket hamapi preuzima povijesne podatke (datalogove) vaših uređaja. Čita retke umjesto vas i daje jedan popis vrijednosti za svako mjerenje. Možete ga slobodno koristiti (MIT licenca).

Instalacija

pip install hamapi

Trebate Python 3.6 ili noviji. Paket također instalira requests i brotli.

Primjer

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: dobivate ga na stranici Račun u aplikaciji. Pogledajte REST API.
'e11:123': serijski broj uređaja. Trebate dopuštenje čitanja na uređaju.
start, end: Unix vrijeme u sekundama.
averaging_step: neobavezno. Paket daje jednu prosječnu vrijednost za svaki korak od toliko sekundi. S 0 (zadana vrijednost) dobivate sve retke.

Rezultat

get_datalog_data vraća rječnik:

timestamp: vrijeme svake vrijednosti, u Unix sekundama.
Jedan popis za svako mjerenje i svaki izlaz uređaja. Ključ je kod mjerenja (na primjer T). Kodovi su na stranici Rječnik mjerenja.

Svi popisi imaju istu duljinu. Bez averaging_step popisi imaju jednu točku više neposredno prije svake promjene. Tako grafikon prikazuje stepenice.

Ostale funkcije

ham.get_user_devices(): uređaji vašeg računa. To su isti podaci kao iz get_user_devices.php.

Napomene

Paket sprema preuzete prošle dane u datoteku .cached.db, u trenutnoj mapi. Te dane ne preuzima ponovno. Da biste ih ponovno preuzeli, izbrišite datoteku.
Paket čita samo povijest. Za podatke uživo pogledajte Podaci uživo (WebSocket).
Paket sadrži definicije uređaja svoje verzije. Za nove vrste uređaja ažurirajte ga naredbom pip install -U hamapi.
Stranica paketa: pypi.org/project/hamapi.

Pogledajte i

Chat s podrškom