Python biblioteka

Python paketas hamapi atsisiunčia Jūsų įrenginių istorinius duomenis (datalogs). Jis už Jus perskaito eilutes ir pateikia po vieną reikšmių sąrašą kiekvienam rodmeniui. Galite jį laisvai naudoti (MIT licencija).

Įdiegimas

pip install hamapi

Jums reikia Python 3.6 arba naujesnės versijos. Paketas taip pat įdiegia requests ir brotli.

Pavyzdys

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: jį gaunate programėlės puslapyje Paskyra. Žr. REST API.
'e11:123': įrenginio serijos numeris. Jums reikia įrenginio skaitymo teisės.
start, end: Unix laikas sekundėmis.
averaging_step: neprivaloma. Paketas pateikia vieną vidutinę reikšmę kiekvienam tiek sekundžių žingsniui. Su 0 (numatytoji reikšmė) gaunate visas eilutes.

Rezultatas

get_datalog_data grąžina žodyną:

timestamp: kiekvienos reikšmės laikas Unix sekundėmis.
Po vieną sąrašą kiekvienam įrenginio rodmeniui ir išvesčiai, su rodmens kodu kaip raktu (pavyzdžiui, T). Kodai yra Rodmenų žodyne.

Visi sąrašai yra tokio paties ilgio. Be averaging_step sąrašai turi vieną papildomą tašką prieš pat kiekvieną pokytį, kad grafikas rodytų laiptelius.

Kitos funkcijos

ham.get_user_devices(): Jūsų paskyros įrenginiai, tie patys duomenys kaip get_user_devices.php.

Pastabos

Paketas saugo atsisiųstas praėjusias dienas faile .cached.db dabartiniame aplanke. Jis šių dienų nesiunčia dar kartą. Kad jas atsisiųstumėte dar kartą, ištrinkite failą.
Paketas skaito tik istoriją. Tiesioginiams duomenims naudokite WebSocket.
Paketas turi savo versijos įrenginių apibrėžtis. Naujiems įrenginių tipams atnaujinkite jį su pip install -U hamapi.
Paketo puslapis: pypi.org/project/hamapi.

Taip pat žr.

Pokalbis su pagalba