Arquitectura

    Headless Telematics: núcleo listo, tu interfaz

    Headless Telematics es un enfoque de arquitectura en el que las capacidades del backend de telemática están disponibles mediante API documentadas y la interfaz del proveedor es opcional: tu equipo construye su propia interfaz sobre un núcleo listo. Interfaz web o móvil, un flujo dentro del proceso de negocio, una integración con el sistema de operación: la elección es tuya y el backend sigue siendo el mismo.

    Ver la documentación Ir a Composable Telematics
    API documentadaIoT Query: acceso de lecturaLa interfaz, bajo tu control
    Consulta · SQL
    SELECT device_id, device_time, lat, lng
    FROM raw_telematics_data.tracking_data_core
    WHERE device_id = 104
    ORDER BY device_time DESC
    LIMIT 1;
    Respuesta · fila de resultado
    { "device_id": 104,
    "device_time": "2026-07-21T14:02:11Z",
    "lat": 43.238, "lng": 76.889 }
    200 · raw_telematics_data · acceso de lectura
    Definición

    Qué es Headless Telematics

    Headless Telematics separa el producto en dos partes: el backend de telemática, con los datos y la lógica, expuesto mediante API documentadas, y la interfaz, que diseña el equipo que construye el producto. El núcleo es uno solo y sobre él puedes construir cualquier interfaz. Navixy funciona según este principio: las capacidades del backend de telemática están disponibles mediante API documentadas, y la documentación describe qué operaciones aplican a cada escenario.

    • Construye un portal, una aplicación móvil, un flujo integrado en el proceso de negocio o una integración con el sistema de operación: la interfaz no se limita a una única opción.
    • La experiencia de usuario, la accesibilidad, la seguridad de la aplicación, el soporte y los lanzamientos de tu interfaz son responsabilidad de tu equipo.
    • La API documentada es la base de la arquitectura: un mismo contrato sirve para la interfaz web, móvil e integrada, y a futuro también para un agente mediante MCP. Navixy MCP
    El camino de la telemática

    Headless: el escalón entre white label y Composable Telematics

    La telemática recorre un camino que va de la interfaz lista, pasando por la arquitectura headless, hasta la plataforma composable, y más allá, hacia la infraestructura agent-ready, donde los datos y la lógica los usan no solo las personas, sino también los agentes de IA. Headless es el escalón en el que el backend ya está expuesto mediante API y la interfaz se vuelve tu terreno de diferenciación.

    • White label y Headless son escalones contiguos y equivalentes: elige la interfaz lista donde rinde, y la propia donde la interfaz se convierte en tu ventaja.
    • Headless ya te da tu propia interfaz sobre un backend documentado; el paso hacia Composable Telematics se puede dar aparte, cuando necesites independencia de datos y lógica. Composable Telematics
    Cómo funciona

    La capa de aplicación conecta tu interfaz con el backend de telemática

    Lo garantiza el backend de telemática

    API documentada y esquema de datos estable; por ejemplo, la tabla raw_telematics_data.tracking_data_core en IoT Query.

    Esquema de datos
    De ello responde tu interfaz

    La capa de aplicación invoca las operaciones y toma solo los campos necesarios; el navegador no se conecta directamente al backend.

    Lo garantiza el backend de telemática

    Acceso de lectura a la telemetría mediante la conexión compatible con PostgreSQL de IoT Query.

    Configuración de la conexión
    De ello responde tu interfaz

    La identificación de usuarios, el resguardo de secretos y los límites de consulta quedan del lado de tu solución.

    Lo garantiza el backend de telemática

    Credenciales de conexión por instancia: aislamiento de tenants a nivel de backend.

    De ello responde tu interfaz

    La correspondencia entre usuario y tenant y la rotación de claves las acuerda tu equipo con Navixy antes del lanzamiento.

    Lo garantiza el backend de telemática

    Lógica operativa en IoT Logic: ingesta de datos, transformaciones, acciones y enrutamiento.

    Operaciones de lógica
    De ello responde tu interfaz

    La interfaz, la accesibilidad, el manejo de errores y el soporte a los usuarios son tu área de responsabilidad.

    Entre la interfaz y el backend trabaja la capa de aplicación de tu equipo: invoca las operaciones documentadas, ejecuta la lógica de negocio y mantiene las credenciales del proveedor en el servidor, no en el navegador.

    • La capa de aplicación verifica los permisos de acceso, considera el contexto del tenant y almacena en caché las consultas al backend.
    • Los registros, los identificadores de solicitud y las comprobaciones de versión enlazan las capas: una falla se diagnostica en minutos.

    Tres operaciones que definen tu arquitectura headless

    Cada una se verifica por separado: la lectura de telemetría, la identificación del tenant y el ciclo de vida de los lanzamientos.

    SQL sobre datos en vivo

    Configuración de conexiónEsquema de datos
    01SELECT *
    02FROM raw_telematics_data.tracking_data_core
    03LIMIT 10;
    raw_business_dataraw_telematics_data
    tracking_data_core

    Acceso documentado y compatible con PostgreSQL a la tabla raw_telematics_data.tracking_data_core: lees los campos necesarios directamente.

    La lógica de aplicación —ingesta de datos, transformaciones JEXL y enrutamiento— es IoT Logic en la capa de aplicación, no un contrato del backend. Operaciones de lógica

      Ver la documentación
      Redistribución de responsabilidades

      Obtienes tu propia interfaz, y la responsabilidad por ella

      Ese intercambio vale la pena cuando la interfaz distingue tu producto en el mercado y el equipo está listo para operarla: autenticación, lanzamientos, incidentes, soporte al cliente. Si las diferencias en la interfaz no crean un valor perceptible para los clientes, el white label sigue siendo una opción rápida y económica: equivalente, no de reserva.

      • Tu equipo diseña la interacción y responde por la accesibilidad, la seguridad del frontend, los lanzamientos y el soporte al cliente.
      • Los responsables del backend y de la aplicación fijan la autenticación, la autorización, los límites de consulta, el versionado y el orden de escalamiento antes del lanzamiento.
      • Un escenario de usuario se recorre completo: acceso denegado, datos obsoletos, falla parcial, cambio de la API por parte del proveedor; así se verifica el límite de responsabilidad, no una única consulta afortunada.
      • El white label sigue siendo una opción rápida y económica si la interfaz propia no crea un valor perceptible para el cliente. White-label
      Límites del backend
      Responde tu equipo
      • Autenticación de los usuarios del portal y sesiones
      • Presentación de datos, accesibilidad y manejo de errores
      La plataforma aporta
      • API documentada del backend de telemática
      • Credenciales de conexión por instancia
      Verificación sobre un solo escenario

      Recorre un escenario, de la conexión al soporte

      Así el límite de responsabilidad se ve en la práctica, incluso antes de la primera línea de la interfaz.

      1. 01Identificación del usuario
      2. 02Conexión según la documentación
      3. 03Consulta a la tabla de datos
      4. 04Presentación y soporte
      5. 05Monitoreo y cambios
      Ver la documentación
      Preguntas sobre la arquitectura

      Preguntas sobre Headless Telematics

      ¿Qué es Headless Telematics?
      Es un enfoque de arquitectura en el que el backend se expone mediante API documentadas y la interfaz del proveedor es opcional. Las capacidades del backend de telemática están disponibles mediante API documentadas, y el equipo construye su propia interfaz sobre un núcleo listo. Un rastreador, una cámara, una TCU o un vehículo sin pantalla son otro tema, de hardware; no forman parte de este término.
      ¿Entonces cada función del backend está disponible mediante API?
      No de forma automática. El conjunto de operaciones y permisos disponibles varía según la superficie de producto: verifícalo en la documentación vigente para cada escenario antes de diseñar la interfaz.
      ¿Quién responde por la seguridad en el modelo Headless Telematics?
      La responsabilidad se reparte a partir del límite del backend. Navixy responde por la protección del backend de telemática dentro de los límites acordados; tu equipo, por tu propia interfaz, las sesiones, las integraciones y los procesos operativos que la rodean.
      ¿Cuándo conviene elegir white label en lugar de Headless?
      Cuando tu propia interfaz no crea un valor perceptible para los clientes. Una interfaz lista con tu marca arranca sin desarrollo de frontend. White label y Headless son escalones equivalentes: elige según dónde la diferencia de interfaz sea realmente significativa para el mercado. White-label
      ¿El navegador debería llamar directamente a la API de telemática?
      Suele ser más confiable hacerlo a través de una capa de aplicación que administra tu equipo. La capa de aplicación centraliza la autorización, el contexto del tenant, los secretos, los límites de consulta y el manejo de los cambios del lado del proveedor: una sola vez, y no en cada aplicación cliente por separado.
      ¿Cómo verificar la arquitectura headless antes del lanzamiento?
      Recorre completo un escenario de usuario real. Para el escenario de lectura de las últimas coordenadas, verifica no solo la consulta exitosa, sino también el acceso denegado, los datos obsoletos o ausentes, los tiempos de espera, la falla parcial, el cambio de esquema y la ruta de escalamiento al soporte. Configuración de conexiónEsquema de datos
      ¿Se puede conservar la interfaz lista como opción de respaldo junto a la solución headless?
      Sí, si lo permiten el producto y las condiciones comerciales. Headless Telematics hace de la interfaz del proveedor una opción, no un requisito: la compatibilidad entre escenarios listos y propios concretos para tu despliegue se confirma con Navixy por separado. White-label
      ¿Cuándo empieza a rendir Headless Telematics?
      Cuando un proceso de negocio importante para el cliente justifica desarrollar tu propia interfaz. El plazo depende de la disponibilidad de las interfaces, el diseño de identificación y tenants, el desarrollo de la aplicación, las pruebas de integración, la revisión de seguridad, la observabilidad y el volumen de migración: no hay un plazo único para todos los escenarios.
      ¿Puede un agente de IA o una herramienta de desarrollador trabajar con el backend headless?
      Sí, mediante el mismo acceso documentado que cualquier integración habitual. Navixy publica MCP para cuentas de usuario y de Admin Panel, además de un MCP público de documentación. El agente pasa la misma autenticación y trabaja dentro de los mismos límites de acceso que cualquier aplicación. Navixy MCP

      Construye tu interfaz sobre el backend documentado de Navixy

      Empieza por un escenario de usuario: define las operaciones de backend necesarias, las zonas de responsabilidad y el ciclo de vida, antes de que el equipo escriba la primera línea de la interfaz.

      Ver la documentación Ir a Composable Telematics

      Headless Telematics expone el backend mediante API; verifica el conjunto de operaciones para tu escenario en la documentación.