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.
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.
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.