Hermetry tiene tres formas de que sus propios sistemas trabajen con su organización, y una API independiente para dispositivos. Esta sección cubre las tres primeras.
| Interfaz | Dirección | Quién lo usa | Inicio de sesión |
|---|---|---|---|
| API REST de gestión | Su sistema llama a Hermetry | ERP, MES, sistemas de tickets, scripts, informes | Clave de API |
| Webhooks | Hermetry llama a su sistema | Cualquier cosa que deba reaccionar a eventos: un dispositivo que se desconecta, una alarma que se abre, un comando que termina | Un secreto de firma que usted verifica |
| Servidores MCP | Un asistente de IA llama a Hermetry | Asistentes de IA que admiten MCP | Clave de API o un inicio de sesión (OAuth) |
| API de dispositivos | Los dispositivos envían datos y reciben comandos | Dispositivos y gateways | Token del dispositivo, usuario y contraseña de MQTT, o certificado |
La API de dispositivos está documentada en la sección de dispositivos: MQTT, API HTTP de dispositivos y temas y payloads MQTT. No utilice una clave de API en un dispositivo, ni un token de dispositivo en una integración.
Qué puede hacer con la API de gestión
Con una clave de API puede hacer desde código lo que un miembro puede hacer en la aplicación, dentro de los permisos que conceda a la clave:
- listar, crear, modificar y eliminar dispositivos y perfiles de dispositivo, y rotar las credenciales de los dispositivos,
- leer y escribir atributos, leer los últimos valores y el historial de telemetría,
- enviar comandos a los dispositivos y leer sus resultados,
- listar, reconocer y resolver alarmas, y reemplazar las reglas de alarma de un perfil,
- construir y leer el árbol de sedes y activos, y colocar dispositivos en él,
- registrar firmware, iniciar despliegues y cambiar la configuración de los dispositivos,
- gestionar gateways y dispositivos LoRaWAN.
La API REST no tiene ruta para escribir telemetría. Las lecturas proceden de los dispositivos (MQTT o HTTP) o de los flujos.
Una primera llamada
- Abra API Keys y cree una clave con el preset Read only del módulo de dispositivos. Consulte Autenticación.
- Encuentre el id de su organización (
tenantId) en la barra de direcciones de la aplicación:https://<su host>/tenant/<tenantId>/admin/.... - Llame a la lista de dispositivos:
curl -s "https://<your host>/tenant/<tenantId>/api/iot/devices?pageSize=5" \
-H "Authorization: Bearer sk_live_…"La respuesta es { "devices": [...], "total": 42 }.
En esta sección
Primeros pasos:
- Autenticación: claves de API, permisos, redes, caducidad, rotación.
- Fundamentos de la API REST: rutas, listas, paginación, ordenación, filtros y convenciones.
- Errores y límites de tasa: el cuerpo de error, cada código de estado y los límites que responden
429.
Referencias de rutas:
- API de dispositivos y perfiles
- API de telemetría y atributos
- API de comandos
- API de alarmas
- API de sedes y activos
- API de firmware y configuración de dispositivos
- API de LoRaWAN
Eventos:
- Webhooks: crear, firmar, reintentar, probar.
- Referencia de eventos de webhook: cada evento de IoT con un ejemplo de payload.
Asistentes de IA:
- Asistentes de IA (MCP): qué puede hacer un asistente y qué no puede hacer nunca.
- Conectar un asistente de IA
- Claves MCP y aplicaciones conectadas
- Referencia de herramientas MCP
- Configuración y seguridad de MCP
Antes de crear una integración
- Dé a cada integración su propia clave, con solo los permisos que necesite. Consulte Endurecimiento de claves de API.
- Espere
429y respeteRetry-After. - Trate los ids como UUID opacos. No los construya usted mismo nunca.
- Prefiera los webhooks al sondeo para detectar cambios: la conexión de un dispositivo, una alarma, el resultado de un comando.
- Las claves de API y los webhooks los gestionan los administradores. Rotar el secreto de firma de un webhook requiere el rol Owner.