API

Resumen de la API de Kilo IoT Server — acceso REST y gRPC, claves con ámbito y endpoints de integración en la nube o locales.

La plataforma Kilo IoT ofrece acceso programático para que los sistemas externos puedan leer y gestionar los datos y la configuración de tu despliegue — y ahora enviar comandos a tus dispositivos —, abarcando integraciones de backend, canalizaciones de análisis e informes, herramientas industriales y de automatización, y aplicaciones personalizadas.

Usa la referencia de la API para la lista completa de endpoints, campos de solicitud, respuestas y ámbitos requeridos. Esta sección cubre para qué sirve la API, cómo elegir un protocolo, cómo se autentican las solicitudes y dónde gestionar las claves.

El control de dispositivos forma parte de la API: una clave con el Comandos ámbito puede crear comandos de un dispositivo y enviarlos como downlinks (encendido/apagado, puntos de consigna y similares). Consulta Comandos del dispositivo para el flujo de trabajo en la aplicación, y el referencia de la API para los endpoints de comandos.

Qué está disponible

Se ofrecen dos protocolos en el mismo endpoint seguro:

• REST — la ruta principal para la mayoría de las integraciones. HTTPS y JSON estándar, utilizables desde cualquier cliente HTTP. Empieza aquí salvo que tengas una razón específica para no hacerlo. Consulta API REST pública.

• gRPC — la ruta avanzada / en las instalaciones. Elige REST salvo que necesites específicamente gRPC para una integración en las instalaciones o tipada de servicio a servicio. Consulta API gRPC.

Junto a ellos, un endpoint independiente sirve a clientes de IA en lugar del código que escribes:

• MCP — conecta un cliente de IA compatible con MCP, como Claude Code o Claude Desktop, a tu organización. Lo autorizas en el navegador con tu cuenta habitual de Kilo en lugar de emitir una clave, y funciona dentro de tus propios permisos. Consulta Servidor MCP.

Autenticación

Las solicitudes se autentican con una clave de API con ámbito en el X-API-Key encabezado (formato kilo_<key>), además del contexto de tu organización en X-Organization-Id. Las claves se crean y gestionan en Configuración → Claves de API; los conceptos se resumen en Autenticación y claves de API, y el flujo completo de gestión de claves se encuentra en Claves de API.

Cloud y en las instalaciones

Las implementaciones en Cloud usan el endpoint gestionado anterior. Las instalaciones on-premise exponen la misma API dentro del perímetro de tu propia red, donde gRPC encaja de forma natural para la automatización interna de servicio a servicio — pero REST sigue estando disponible y sigue siendo el punto de partida más sencillo.

En esta sección

• API REST pública — la ruta estándar de integración.

• API gRPC — la ruta avanzada / en las instalaciones (tipada, de servicio a servicio).

• Servidor MCP — conecta tu propio cliente de IA a tu organización.

• Autenticación y claves de API — cómo se autorizan las solicitudes.

• Ejemplos — una solicitud autenticada mínima para empezar.