Biblioteca Python

Pachetul Python hamapi descarcă datele istorice (datalogs) ale dispozitivelor dumneavoastră. Citește rândurile în locul dumneavoastră și dă o listă de valori pentru fiecare măsurătoare. Îl puteți folosi liber (licență MIT).

Instalare

pip install hamapi

Aveți nevoie de Python 3.6 sau mai nou. Pachetul instalează și requests și brotli.

Exemplu

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: o obțineți din pagina Cont a aplicației. Consultați API REST.
'e11:123': numărul de serie al dispozitivului. Aveți nevoie de permisiune de citire pe dispozitiv.
start, end: timp Unix în secunde.
averaging_step: opțional. Pachetul dă o valoare medie pentru fiecare pas de acest număr de secunde. Cu 0 (valoarea implicită) primiți toate rândurile.

Rezultatul

get_datalog_data returnează un dicționar:

timestamp: ora fiecărei valori, în secunde Unix.
O listă pentru fiecare măsurătoare și fiecare ieșire a dispozitivului. Cheia este codul măsurătorii (de exemplu T). Codurile sunt în pagina Dicționar de măsurători.

Toate listele au aceeași lungime. Fără averaging_step, listele au un punct în plus chiar înainte de fiecare schimbare. Astfel, un grafic arată trepte.

Alte funcții

ham.get_user_devices(): dispozitivele contului dumneavoastră. Sunt aceleași date ca în get_user_devices.php.

Note

Pachetul păstrează zilele trecute descărcate în fișierul .cached.db, în folderul curent. Nu descarcă din nou aceste zile. Pentru a le descărca din nou, ștergeți fișierul.
Pachetul citește numai istoricul. Pentru date în timp real, consultați Date în timp real (WebSocket).
Pachetul conține definițiile de dispozitive ale versiunii sale. Pentru tipuri noi de dispozitive, actualizați-l cu pip install -U hamapi.
Pagina pachetului: pypi.org/project/hamapi.

Vedeți și

Chat cu suportul