API IoT para desarrolladores — REST, gRPC, streaming | Kilo

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.

01

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.

02

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.

03

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.

04

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
Hablemos de tu on-premise

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.