Библиотека за 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.

Вижте също

Чат с поддръжката