Biblioteca de Python

El paquete de Python hamapi descarga los datos históricos (datalogs) de sus dispositivos. Lee las filas por usted y devuelve una lista de valores para cada lectura. Puede usarlo libremente (licencia MIT).

Instalación

pip install hamapi

Necesita Python 3.6 o posterior. El paquete también instala requests y brotli.

Ejemplo

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: la obtiene en la página Cuenta de la app. Consulte la API REST.
'e11:123': el número de serie del dispositivo. Necesita permiso de lectura en el dispositivo.
start, end: tiempo Unix en segundos.
averaging_step: opcional. El paquete devuelve un valor medio para cada paso de este número de segundos. Con 0 (el valor predeterminado) obtiene todas las filas.

El resultado

get_datalog_data devuelve un diccionario:

timestamp: la hora de cada valor, en segundos Unix.
Una lista para cada lectura y cada salida del dispositivo. La clave es el código de la lectura (por ejemplo T). Los códigos están en el Diccionario de lecturas.

Todas las listas tienen la misma longitud. Sin averaging_step, las listas tienen un punto más justo antes de cada cambio. Así, un gráfico muestra escalones.

Otras funciones

ham.get_user_devices(): los dispositivos de su cuenta. Son los mismos datos que get_user_devices.php.

Notas

El paquete guarda los días pasados descargados en el archivo .cached.db, en la carpeta actual. No descarga estos días otra vez. Para descargarlos otra vez, elimine el archivo.
El paquete lee solo el historial. Para datos en vivo, consulte Datos en directo (WebSocket).
El paquete contiene las definiciones de dispositivos de su versión. Para tipos de dispositivo nuevos, actualícelo con pip install -U hamapi.
Página del paquete: pypi.org/project/hamapi.

Vea también

Chat con soporte