Python bibliotēka

Python pakotne hamapi lejupielādē jūsu ierīču vēsturiskos datus (datalogs). Tā nolasa rindas jūsu vietā un dod vienu vērtību sarakstu katram mērījumam. Jūs varat to brīvi izmantot (MIT licence).

Instalēšana

pip install hamapi

Jums vajag Python 3.6 vai jaunāku versiju. Pakotne instalē arī requests un brotli.

Piemērs

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: jūs to saņemat lietotnes lapā Konts. Skatiet REST API.
'e11:123': ierīces sērijas numurs. Jums vajag lasīšanas atļauju ierīcei.
start, end: Unix laiks sekundēs.
averaging_step: neobligāts. Pakotne dod vienu vidējo vērtību katram solim ar tik daudz sekundēm. Ar 0 (noklusējums) jūs saņemat visas rindas.

Rezultāts

get_datalog_data atgriež vārdnīcu:

timestamp: katras vērtības laiks Unix sekundēs.
Viens saraksts katram ierīces mērījumam un katrai izejai ar mērījuma kodu kā atslēgu (piemēram, T). Kodi ir lapā Mērījumu vārdnīca.

Visiem sarakstiem ir vienāds garums. Bez averaging_step sarakstos ir vēl viens punkts tieši pirms katras izmaiņas, lai diagramma rādītu pakāpienus.

Citas funkcijas

ham.get_user_devices(): jūsu konta ierīces, tie paši dati kā get_user_devices.php.

Piezīmes

Pakotne glabā lejupielādētās pagātnes dienas failā .cached.db pašreizējā mapē. Tā šīs dienas vairs nelejupielādē. Lai tās lejupielādētu vēlreiz, dzēsiet failu.
Pakotne lasa tikai vēsturi. Tiešsaistes datiem izmantojiet WebSocket.
Pakotnē ir tās versijas ierīču definīcijas. Jauniem ierīču veidiem atjauniniet to ar pip install -U hamapi.
Pakotnes lapa: pypi.org/project/hamapi.

Skatiet arī

Tērzēt ar atbalstu