Knižnica pre Python

Balík Python hamapi sťahuje historické údaje (datalogy) vašich zariadení. Prečíta riadky za vás a dá jeden zoznam hodnôt pre každé meranie. Môžete ho voľne používať (licencia MIT).

Inštalácia

pip install hamapi

Potrebujete Python 3.6 alebo novší. Balík nainštaluje aj requests a brotli.

Príklad

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: získate ho zo stránky Účet v aplikácii. Pozrite REST API.
'e11:123': sériové číslo zariadenia. Potrebujete oprávnenie na čítanie zariadenia.
start, end: čas Unix v sekundách.
averaging_step: voliteľné. Balík dá jednu priemernú hodnotu pre každý krok s týmto počtom sekúnd. S 0 (predvolené) dostanete všetky riadky.

Výsledok

get_datalog_data vráti slovník:

timestamp: čas každej hodnoty v sekundách Unix.
Jeden zoznam pre každé meranie a každý výstup zariadenia. Kľúč je kód merania (napríklad T). Kódy sú v Slovníku meraní.

Všetky zoznamy majú rovnakú dĺžku. Bez averaging_step majú zoznamy jeden bod navyše tesne pred každou zmenou, aby graf ukázal schody.

Iné funkcie

ham.get_user_devices(): zariadenia vášho účtu, tie isté údaje ako get_user_devices.php.

Poznámky

Balík uchováva stiahnuté minulé dni v súbore .cached.db v aktuálnom priečinku. Tieto dni znova nesťahuje. Ak ich chcete stiahnuť znova, vymažte súbor.
Balík číta iba históriu. Pre živé údaje použite WebSocket.
Balík obsahuje definície zariadení svojej verzie. Pre nové typy zariadení ho aktualizujte príkazom pip install -U hamapi.
Stránka balíka: pypi.org/project/hamapi.

Pozrite aj

Chat s podporou