Python библиотека

Python пакет hamapi преузима историјске податке (datalogs) ваших уређаја. Чита редове уместо вас и даје једну листу вредности за свако очитавање. Можете слободно да га користите (MIT лиценца).

Инсталација

pip install hamapi

Потребан вам је Python 3.6 или новији. Пакет инсталира и requests и brotli.

Пример

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: добијате га са странице Налог у апликацији. Погледајте REST API.
'e11:123': серијски број уређаја. Потребна вам је дозвола за читање на уређају.
start, end: Unix време у секундама.
averaging_step: опционо. Пакет даје једну просечну вредност за сваки корак од толико секунди. Са 0 (подразумевано) добијате све редове.

Резултат

get_datalog_data враћа речник:

timestamp: време сваке вредности, у Unix секундама.
Једна листа за свако очитавање и сваки излаз уређаја, са кодом очитавања као кључем (на пример T). Кодови су у Речник очитавања.

Све листе имају исту дужину. Без averaging_step листе имају једну тачку више непосредно пре сваке промене, да графикон приказује степенике.

Друге функције

ham.get_user_devices(): уређаји вашег налога, исти подаци као get_user_devices.php.

Напомене

Пакет чува преузете прошле дане у датотеци .cached.db, у тренутној фасцикли. Не преузима поново ове дане. Да их поново преузмете, обришите датотеку.
Пакет чита само историју. За податке уживо користите WebSocket.
Пакет садржи дефиниције уређаја своје верзије. За нове врсте уређаја ажурирајте га командом pip install -U hamapi.
Страница пакета: pypi.org/project/hamapi.

Погледајте и

Ћаскање са подршком