Inicio rápido

Versión del paquete: 0.2.1

Esta guía corresponde a tecsci-cloud-api 0.2.1.

Guardá este programa como consulta.py. Antes de ejecutarlo, completá la instalación y configurá la variable de entorno. El ejemplo realiza una lectura; el nombre sensor-001 es ficticio.

import os
from tecsci_cloud_python_api import TecsciCloudClient


def main():
    api_key = os.environ.get("TECSCI_CLOUD_API_KEY")
    if not api_key or not api_key.strip():
        raise SystemExit("Falta configurar TECSCI_CLOUD_API_KEY.")

    try:
        with TecsciCloudClient(api_key=api_key) as client:
            datos = client.get_latest_device_telemetry(
                "sensor-001", ["temperature", "humidity"]
            )
            if datos:
                print(datos)
            else:
                print("No hay mediciones disponibles para esas claves.")
    except LookupError:
        raise SystemExit("No se encontró el dispositivo solicitado.")
    except ValueError:
        raise SystemExit("Revisá la clave y los parámetros de la consulta.")
    except Exception as error:
        estado = getattr(error, "status", None)
        if estado is None:
            estado = getattr(getattr(error, "response", None), "status_code", None)
        if estado == 401:
            mensaje = "Autenticación rechazada: revisá la API key."
        elif estado == 403:
            mensaje = "Acceso denegado: revisá los permisos de la API key."
        else:
            mensaje = "No se pudo consultar Tecsci Cloud. Revisá conexión y certificados."
        raise SystemExit(mensaje) from None


if __name__ == "__main__":
    main()

python consulta.py

El bloque with cierra la conexión al salir, incluso si falla la consulta. La autenticación ocurre al construir el cliente, antes de entrar al bloque. El manejo general de errores evita depender de clases adicionales y no imprime el contenido de la excepción.

Una respuesta ilustrativa, completamente ficticia:

{
  "temperature": [{"ts": 1767225600000, "value": "21.5"}],
  "humidity": [{"ts": 1767225600000, "value": "45"}]
}

Cada clave contiene una lista de puntos con ts (Unix epoch en milisegundos) y value. No supongas que los valores son siempre numéricos ni que todas las claves tienen datos. Continuá con Consultas.