Librerija Python

Il-pakkett Python hamapi iniżżel id-data storika (datalogs) tal-apparati tagħkom. Jaqra r-ringieli għalikom u jagħti lista waħda ta’ valuri għal kull qari. Tistgħu tużawh liberament (liċenzja MIT).

Installazzjoni

pip install hamapi

Għandkom bżonn Python 3.6 jew aktar ġdid. Il-pakkett jinstalla wkoll requests u brotli.

Eżempju

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: tiksbuha mill-paġna Kont tal-app. Araw ir-REST API.
'e11:123': in-numru tas-serje tal-apparat. Għandkom bżonn permess tal-qari fuq l-apparat.
start, end: ħin Unix f’sekondi.
averaging_step: fakultattiv. Il-pakkett jagħti valur medju wieħed għal kull pass ta’ dawn is-sekondi. B’0 (id-default) tieħdu r-ringieli kollha.

Ir-riżultat

get_datalog_data jagħti dizzjunarju:

timestamp: il-ħin ta’ kull valur, f’sekondi Unix.
Lista waħda għal kull qari u għal kull output tal-apparat, bil-kodiċi tal-qari bħala ċ-ċavetta (pereżempju T). Il-kodiċijiet jinsabu fid-Dizzjunarju tal-qari.

Il-listi kollha għandhom l-istess tul. Mingħajr averaging_step, il-listi għandhom punt wieħed żejjed eżatt qabel kull bidla, biex graff juri t-tarġiet.

Funzjonijiet oħra

ham.get_user_devices(): l-apparati tal-kont tagħkom, l-istess data ta’ get_user_devices.php.

Noti

Il-pakkett iżomm il-ġranet li għaddew li niżżel fil-fajl .cached.db, fil-folder attwali. Ma jerġax iniżżel dawn il-ġranet. Biex tniżżluhom mill-ġdid, ħassru l-fajl.
Il-pakkett jaqra biss l-istorja. Għad-data live, użaw il-WebSocket.
Il-pakkett fih id-definizzjonijiet tal-apparati tal-verżjoni tiegħu. Għal tipi ġodda ta’ apparati, aġġornawh b’pip install -U hamapi.
Il-paġna tal-pakkett: pypi.org/project/hamapi.

Araw ukoll

Chat mal-appoġġ