Python-safn

Python-pakkinn hamapi sækir söguleg gögn (datalogs) tækjanna þinna. Hann les línurnar fyrir þig og gefur einn lista af gildum fyrir hverja mælingu. Þú mátt nota hann frjálst (MIT-leyfi).

Uppsetning

pip install hamapi

Þú þarft Python 3.6 eða nýrra. Pakkinn setur líka upp requests og brotli.

Dæmi

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: þú færð hann á síðunni Reikningur í appinu. Sjá REST API.
• 'e11:123': raðnúmer tækisins. Þú þarft lesheimild á tækinu.
• start, end: Unix-tími í sekúndum.
• averaging_step: valfrjálst. Pakkinn gefur eitt meðalgildi fyrir hvert skref með þessum fjölda sekúndna. Með 0 (sjálfgefið) færðu allar línurnar.

Niðurstaðan

get_datalog_data skilar orðabók (dictionary):

• timestamp: tími hvers gildis, í Unix-sekúndum.
• Einn listi fyrir hverja mælingu og hvert úttak tækisins, með kóða mælingarinnar sem lykil (til dæmis T). Kóðarnir eru í Orðabók mælinga.

Allir listarnir eru jafnlangir. Án averaging_step hafa listarnir einum punkti meira rétt fyrir hverja breytingu, svo að graf sýni þrep.

Önnur föll

• ham.get_user_devices(): tæki reikningsins þíns, sömu gögn og get_user_devices.php.

Athugasemdir

• Pakkinn geymir sótta liðna daga í skránni .cached.db, í núverandi möppu. Hann sækir þessa daga ekki aftur. Til að sækja þá aftur eyðirðu skránni.
• Pakkinn les aðeins söguna. Fyrir gögn í rauntíma notarðu WebSocket.
• Pakkinn inniheldur skilgreiningar tækjanna fyrir sína útgáfu. Fyrir nýjar gerðir tækja uppfærirðu hann með pip install -U hamapi.
• Síða pakkans: pypi.org/project/hamapi.

Sjá líka

• Sækja söguleg gögn
• REST API
• Gögn í rauntíma (WebSocket)