Guía de integración de la API pública de ZenduONE
Conecta tus propios sistemas a ZenduONE con la API REST pública: obtén credenciales y haz tu primera llamada.
Resumen
La API REST pública de ZenduONE conecta tus propios sistemas, como un ERP, un almacén de datos, Power BI o un asistente de IA, con los datos de tu flota: dispositivos, conductores, viajes, eventos de seguridad, video, mantenimiento y despacho. Solo devuelve los datos de tu propia empresa.
Dirección:
https://trax-public-api.zendu.one/v1Autenticación: ID de cliente y secreto, que se canjean por un token válido durante 1 hora
Control de acceso: scopes por área, de lectura o escritura
Límite de solicitudes: unas 120 solicitudes por minuto por credencial
Documentación: trax-public-api.zendu.one/docs
Asistentes de IA: servidor MCP de ZenduONE
Una credencial no se puede limitar a grupos o vehículos concretos: ve todos los registros de la empresa que permiten sus scopes. Tenlo en cuenta antes de dar acceso a la API a un socio.
API REST pública
Obtén credenciales
Si tu cuenta de ZenduONE muestra API Credentials en More, al final del menú izquierdo, un administrador de la empresa puede crear credenciales ahí. Si no aparece, escribe a servicedesk@zenduit.com para pedir acceso.
Haz clic en More y luego en API Credentials, en Admin. También puedes abrir Admin Settings y elegir la tarjeta API Credentials.
Haz clic en Create credential.
Escribe un Credential Name que indique qué la usa, por ejemplo "Sincronización nocturna de Power BI".
En Scopes, marca Read o Write para cada área que necesite la integración. Evita Select all salvo que la integración lo necesite todo.
Haz clic en Create y copia el Client ID y el Client Secret en tu almacén de secretos. El secreto solo se muestra una vez. Haz clic en Done.


Cada credencial de la lista tiene, a la derecha, Edit (cambiar el nombre o los scopes), Rotate (generar un secreto nuevo, que se muestra una vez) y Delete (eliminarla de forma permanente). Crea una credencial por integración para poder desactivar una sin afectar a las demás.

Obtén un token y haz tu primera llamada
Canjea el ID de cliente y el secreto por un token de acceso y envíalo en cada solicitud. Los tokens duran una hora: guarda uno en caché y pide uno nuevo cuando caduque. Si omites scope, recibes todos los scopes que tiene la credencial.
curl -sS 'https://service-prod.zendu.one/Public/OAuth/Token' \
-d grant_type=client_credentials \
-d client_id=$CLIENT_ID \
-d client_secret=$CLIENT_SECRET \
-d scope='devices:read trips:read'curl -sS 'https://trax-public-api.zendu.one/v1/devices?limit=2' \
-H "Authorization: Bearer $ACCESS_TOKEN"Cada respuesta tiene data (lo que pediste) y meta (un request_id, más count, has_more y next_cursor en las listas). Las listas devuelven hasta 1000 filas; envía next_cursor como cursor para obtener la página siguiente. Las listas por fecha, como viajes y eventos de seguridad, muestran por defecto los últimos 30 días, y la mayoría permite como máximo 31 días por solicitud.
Casos de uso
Panel de la flota en vivo en Power BI: lista los dispositivos con encendido, velocidad y última ubicación conocida. Scope:
devices:read.Informe semanal de kilometraje: lista los viajes y los resúmenes de vehículos. Scopes:
trips:read,summaries:read.Resumen de seguridad de los lunes: lista los eventos de seguridad de la semana pasada. Scopes:
safety:read,drivers:read.Video de un incidente para un reclamo al seguro: solicita el video y luego consulta el estado de la tarea. Scopes:
media:write,media:read.De códigos de falla a solicitudes de mantenimiento: lista las fallas y crea una solicitud de mantenimiento. Scopes:
faults:read,maintenance:write.Trabajos desde tu sistema de pedidos: crea un trabajo y asigna un vehículo. Scope:
jobs:write.Kilometraje IFTA trimestral: lista los resúmenes IFTA. Scope:
ifta:read.
Protege tus credenciales
Guarda el secreto en un gestor de secretos o en la configuración segura de tu herramienta de integración, nunca en código, hojas de cálculo, correo ni chat.
Nunca pongas el secreto, ni un token obtenido con él, en una página web, una app móvil o una app de ZenduONE: cualquiera puede leerlos ahí.
Da a cada credencial solo los scopes que usa, rota el secreto cuando se vaya alguien que lo conocía y elimina las credenciales que nadie usa.
Recursos
Referencia interactiva de la API, donde Authorize te permite probar llamadas con tu token
Referencia de entidades con todos los campos y filtros
openapi.json para importar en Postman o Insomnia
Configuración del servidor MCP para Claude, n8n y otros asistentes de IA
Soporte
Acceso a la API y credenciales: servicedesk@zenduit.com
Preguntas de integración y desarrollo: integrations@zenduit.com
¿Fue útil esto?
Más en SDK de Integración GoZen
Guía de Integración de la API de Zendu Connect¿Aún necesitas ayuda? Pregunta al equipo