Solución de problemas

Versión del paquete: 0.2.1

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

Síntoma	Qué revisar
ModuleNotFoundError	Instalá el paquete en el mismo intérprete que ejecuta el programa. El import es tecsci_cloud_python_api.
Variable ausente	Configurá TECSCI_CLOUD_API_KEY en la sesión que inicia Python. No imprimas su valor para comprobarla.
Clave inválida o 401	Revisá vigencia, revocación y errores al copiar la clave; cargá una clave autorizada.
403	Pedí al administrador que revise permisos sobre la entidad y operación.
Entidad no encontrada	Revisá nombre o etiqueta, permisos y cliente. Los nombres de esta guía son ficticios.
Resultado vacío	Revisá claves, rango temporal en milisegundos y tipo de activo. Algunos métodos convierten errores en resultados vacíos.
Red o certificados	Comprobá conectividad, fecha del equipo y certificados de confianza con el responsable del equipo. No desactives la verificación TLS.
Comando no encontrado	Activá el entorno virtual donde instalaste el paquete.

Mismo paquete, mismo intérprete

pip puede pertenecer a otro Python. Usá siempre el intérprete con el que ejecutarás el programa:

python -m pip show tecsci-cloud-api
python -c "import sys; print(sys.executable)"
python -c "from importlib.metadata import version; print(version('tecsci-cloud-api'))"

En PowerShell, si no activaste el entorno, reemplazá python por .\.venv\Scripts\python.exe. En notebooks, verificá el intérprete del kernel.

Comprobación de la variable sin revelar la clave:

import os

print("Configurada" if os.environ.get("TECSCI_CLOUD_API_KEY", "").strip() else "Ausente")

Errores parciales

No todos los errores se lanzan como excepciones. get_latest_devices_telemetry y varias operaciones en lote incluyen errores por entidad en el resultado. get_device_telemetry puede devolver {} ante una falla de consulta, mientras que get_asset_telemetry y get_asset_telemetry_keys pueden devolver [].

Al solicitar ayuda, indicá versión, operación y código HTTP si está disponible. Revisá y ocultá credenciales, datos e identificadores antes de compartir registros. Consultá Autenticación y Seguridad.