01 · OBSERVAR
Desarrolladores
Una sola API IoT para todo lo que construyas
REST con HTTPS y JSON estándar, gRPC donde importan los contratos tipados, streams en tiempo real por WebSocket y SSE — autenticado con claves API de alcance acotado e idéntico en la nube y on-premise.
api.kiloiot.io
200 OK$ curl -sS https://api.kiloiot.io/api/v2/devices \
-H "X-API-Key: $KILO_API_KEY" \
-H "X-Organization-Id: $KILO_ORG_ID" Una petición autenticada mínima: dos cabeceras, HTTPS estándar y JSON de vuelta.
Protocolos
REST primero, gRPC cuando lo necesites, streams para datos en vivo
Dos protocolos y streams en tiempo real sobre el mismo endpoint seguro: elige la superficie que encaje con tu integración y conserva las mismas claves acotadas.
La vía principal
API REST
HTTPS y JSON estándar, utilizables desde cualquier cliente HTTP. Lee el estado de los dispositivos y el historial de sensores, gestiona paneles y conexiones, trabaja con las reglas y sus versiones, y envía comandos a los dispositivos — todo lo que permitan los alcances de tu clave.
- HTTPS + JSON desde cualquier lenguaje o herramienta
- Dispositivos, sensores, paneles, reglas, comandos
- Documentada endpoint a endpoint en api.kiloiot.io
La vía avanzada
API gRPC
Una interfaz tipada para integración entre servicios: clientes generados y un contrato estable, con la misma autenticación por clave API que REST. Encaja de forma natural en instalaciones on-premise que conectan sistemas internos.
- Clientes tipados y generados
- Integración entre servicios y on-premise
- La misma autenticación X-API-Key que REST
Sin polling
Streams en tiempo real
La telemetría en vivo está disponible externamente por WebSocket y Server-Sent Events (SSE) — los mismos mecanismos que usan los paneles de la plataforma — para que tus sistemas consuman los datos según llegan, sin consultar una y otra vez.
- Endpoints WebSocket y SSE
- Los mismos streams sobre los que corren los paneles
- Los datos según llegan — sin ciclos de refresco
Seguridad
Claves API acotadas, diseñadas para el mínimo privilegio
Cada petición — REST o gRPC — se autentica con una clave acotada en la cabecera X-API-Key más tu organización en X-Organization-Id. Las claves se crean y gestionan en Settings → API Keys.
Alcances Read y Write por área
Dispositivos, sensores, paneles, reglas, comandos, conexiones y más: la mayoría de las áreas separan lectura y escritura, y una clave concede solo lo que selecciones al crearla.
Se muestra una vez, se rota en un clic
El valor completo de la clave aparece una sola vez al crearla; después solo queda visible un prefijo corto. La rotación genera un valor nuevo y desactiva la clave antigua al instante — la única vía de recuperación si se pierde.
Caducidad, estado y último uso
Pon fecha de caducidad a las claves temporales o de contratistas, y sigue el estado de cada clave — Active, Rotated o Revoked — junto con la marca de tiempo de su última llamada.
Aislamiento por organización
Una clave pertenece a la organización donde se creó, y la organización de cada petición debe coincidir: la clave de un cliente jamás puede tocar los datos de otro.
Settings → API Keys
⚠ Copy this key now. You will not be able to see it again.
| Name | Scopes | Status | Last Used |
|---|---|---|---|
| wms-sync-prod kilo_9f2… | Devices · ReadSensors · Read | Active | 2026-07-01 14:32 |
| analytics-pipeline kilo_c41… | Dashboards · Read | Active | 2026-07-01 09:05 |
| ci-deploy-rules kilo_77a… | Rules · Write | Rotated | 2026-06-12 18:20 |
| contractor-audit kilo_e08… | Logs · Read | Revoked | 2026-05-30 11:47 |
Gestionado en Settings → API Keys: una clave por integración, acotada exactamente a lo que necesita.
IA física
¿Qué es un sistema operativo para el IoT y la IA física?
Es una sola capa detrás de cada dispositivo conectado de un sitio. Sensores, cámaras, máquinas y robots de distintos fabricantes y protocolos comparten contexto a través de ella, de modo que un evento puede activar una respuesta de todos mientras cada dispositivo conserva su propio software. Kilo prueba los escenarios antes de que actúen sobre equipos reales, registra lo que cada comando hizo realmente y deja en manos de las personas las decisiones importantes.
Explorar la plataforma de IA física→02 · PROBAR
Depura reglas con respuestas simuladas
03 · APROBAR
Revisa los comandos directos del asistente
04 · VERIFICAR
Revisa el estado y la respuesta de los comandos
Despliegue
La misma API IoT en la nube y en tu propia infraestructura
Las integraciones construidas contra el endpoint en la nube se trasladan sin cambios a una instalación autoalojada: una sola superficie de API, corra donde corra el servidor.
Kilo Cloud
El endpoint gestionado: crea una clave en Settings → API Keys y empieza a llamar a la API, sin infraestructura propia que operar.
- Endpoint gestionado y seguro
- Empieza gratis — sin datos de pago
- Referencia completa de la API en api.kiloiot.io
Kilo On-Premise
El mismo servidor, autoalojado dentro de tu propio perímetro de red — con la misma API REST y gRPC y las mismas claves acotadas: nada cambia en tus integraciones.
- Corre dentro de tu perímetro de red
- API idéntica — las integraciones se portan sin cambios
- gRPC como opción natural para la automatización interna entre servicios
Open source
KiloCenter — el service center mioty de código abierto
KiloCenter es nuestro service center mioty de código abierto, publicado bajo licencia AGPL y desarrollado a la vista de todos en GitHub. Opera la parte mioty de tu red como un producto por derecho propio — pensado para desarrolladores que quieren ser dueños de su stack.
Intégralo por gRPC y MQTT, despliégalo con Docker o Kubernetes y conéctalo a lo que tengas aguas abajo. ¿Prefieres no operarlo tú? La Enterprise Edition viene integrada en Kilo Cloud, o te la licenciamos para tus instalaciones.
Desarrolladores
FAQ para desarrolladores
¿Cómo autentico las peticiones a la API?
Cada petición lleva una clave API acotada en la cabecera X-API-Key (formato kilo_<clave>) más el ID de tu organización en X-Organization-Id. Las claves se crean en Settings → API Keys y todo el tráfico va sobre TLS.
¿Debo usar REST o gRPC?
Empieza con REST: es la vía principal y funciona desde cualquier cliente HTTP. Elige gRPC cuando necesites específicamente clientes tipados generados o integración entre servicios, normalmente on-premise. Ambos se autentican igual.
¿Puedo recibir datos en tiempo real sin polling?
Sí. Los streams en vivo están disponibles por WebSocket y Server-Sent Events (SSE) — los mismos mecanismos que los paneles de la plataforma usan internamente — así que tus sistemas reciben los datos según llegan.
¿Es la misma API en una instalación on-premise?
Sí. Una instalación on-premise expone la misma API dentro de tu propio perímetro de red, así que las integraciones construidas contra la nube se trasladan sin cambios — y allí gRPC encaja de forma natural para la automatización interna.
Empieza a construir sobre la API IoT de Kilo
Crea una cuenta gratis, genera una clave acotada y haz tu primera llamada en minutos — o reserva una llamada para planificar un despliegue on-premise.