Knjižnica za Python

Paket za Python hamapi prenese zgodovinske podatke (datalogs) vaših naprav. Namesto vas prebere vrstice in vrne en seznam vrednosti za vsak odčitek. Uporabljate ga lahko prosto (licenca MIT).

Namestitev

pip install hamapi

Potrebujete Python 3.6 ali novejši. Paket namesti tudi requests in brotli.

Primer

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: dobite ga na strani Račun v aplikaciji. Glejte REST API.
'e11:123': serijska številka naprave. Potrebujete dovoljenje za branje naprave.
start, end: čas Unix v sekundah.
averaging_step: neobvezno. Paket vrne eno povprečno vrednost za vsak korak s tem številom sekund. Z 0 (privzeta vrednost) dobite vse vrstice.

Rezultat

get_datalog_data vrne slovar:

timestamp: čas vsake vrednosti, v sekundah Unix.
En seznam za vsak odčitek in vsak izhod naprave. Ključ je koda odčitka (na primer T). Kode so na strani Slovar odčitkov.

Vsi seznami imajo enako dolžino. Brez averaging_step imajo seznami eno točko več tik pred vsako spremembo. Tako graf prikaže stopnice.

Druge funkcije

ham.get_user_devices(): naprave vašega računa. To so isti podatki kot iz get_user_devices.php.

Opombe

Paket shrani prenesene pretekle dni v datoteko .cached.db v trenutni mapi. Teh dni ne prenese znova. Če jih želite prenesti znova, izbrišite datoteko.
Paket bere samo zgodovino. Za podatke v živo glejte Podatki v živo (WebSocket).
Paket vsebuje definicije naprav svoje različice. Za nove vrste naprav ga posodobite z ukazom pip install -U hamapi.
Stran paketa: pypi.org/project/hamapi.

Glejte tudi

Klepet s podporo