Ir al contenido principal
SDK de Integración GoZen

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/v1

  • Autenticació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.

  1. Haz clic en More y luego en API Credentials, en Admin. También puedes abrir Admin Settings y elegir la tarjeta API Credentials.

  2. Haz clic en Create credential.

  3. Escribe un Credential Name que indique qué la usa, por ejemplo "Sincronización nocturna de Power BI".

  4. 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.

  5. 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.

El menú More con API Credentials en Admin
El diálogo Create API Credential con un campo de nombre y casillas de scopes Read y Write

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.

La lista API Credentials con las acciones de editar, rotar y eliminar

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

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

Soporte