> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-es/kilo-iot-server/api.md). # 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**](https://api.kiloiot.io/) 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](/kilo-docs-es/kilo-iot-server/devices/commands.md) para el flujo de trabajo en la aplicación, y el [referencia de la API](https://api.kiloiot.io/#tag/commands) 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](/kilo-docs-es/kilo-iot-server/api/public-rest-api.md). * **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](/kilo-docs-es/kilo-iot-server/api/grpc-api.md). 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](/kilo-docs-es/kilo-iot-server/api/mcp-server.md). ## Autenticación Las solicitudes se autentican con una clave de API con ámbito en el `X-API-Key` encabezado (formato `kilo_`), 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](/kilo-docs-es/kilo-iot-server/api/authentication-and-api-keys.md), y el flujo completo de gestión de claves se encuentra en [Claves de API](/kilo-docs-es/kilo-iot-server/settings/api-keys.md). ## 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](/kilo-docs-es/kilo-iot-server/api/public-rest-api.md) — la ruta estándar de integración. * [API gRPC](/kilo-docs-es/kilo-iot-server/api/grpc-api.md) — la ruta avanzada / en las instalaciones (tipada, de servicio a servicio). * [Servidor MCP](/kilo-docs-es/kilo-iot-server/api/mcp-server.md) — conecta tu propio cliente de IA a tu organización. * [Autenticación y claves de API](/kilo-docs-es/kilo-iot-server/api/authentication-and-api-keys.md) — cómo se autorizan las solicitudes. * [Ejemplos](/kilo-docs-es/kilo-iot-server/api/examples.md) — una solicitud autenticada mínima para empezar. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.kiloiot.io/kilo-docs-es/kilo-iot-server/api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.