Python-bibliotheek

Het Python-pakket hamapi downloadt de historische gegevens (datalogs) van uw apparaten. Het leest de rijen voor u en geeft één lijst met waarden voor elke meting. U mag het vrij gebruiken (MIT-licentie).

Installatie

pip install hamapi

U hebt Python 3.6 of nieuwer nodig. Het pakket installeert ook requests en brotli.

Voorbeeld

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: u vindt deze op de pagina Account van de app. Zie de REST API.
'e11:123': het serienummer van het apparaat. U hebt leesrechten op het apparaat nodig.
start, end: Unix-tijd in seconden.
averaging_step: optioneel. Het pakket geeft één gemiddelde waarde voor elke stap van dit aantal seconden. Met 0 (de standaardwaarde) krijgt u alle rijen.

Het resultaat

get_datalog_data geeft een dictionary terug:

timestamp: de tijd van elke waarde, in Unix-seconden.
Eén lijst voor elke meting en elke uitgang van het apparaat. De sleutel is de code van de meting (bijvoorbeeld T). De codes staan in het Woordenboek van metingen.

Alle lijsten hebben dezelfde lengte. Zonder averaging_step hebben de lijsten één extra punt vlak voor elke wijziging. Zo toont een grafiek trappen.

Andere functies

ham.get_user_devices(): de apparaten van uw account. Dit zijn dezelfde gegevens als bij get_user_devices.php.

Opmerkingen

Het pakket bewaart de gedownloade dagen uit het verleden in het bestand .cached.db, in de huidige map. Het downloadt deze dagen niet opnieuw. Verwijder het bestand om ze opnieuw te downloaden.
Het pakket leest alleen de geschiedenis. Zie voor live gegevens Live gegevens (WebSocket).
Het pakket bevat de apparaatdefinities van zijn versie. Werk het voor nieuwe apparaattypen bij met pip install -U hamapi.
Pagina van het pakket: pypi.org/project/hamapi.

Zie ook

Chat met support