Developer Ecosystem
Construya el futuro de la movilidad sobre SyncVelo
Interfaces abiertas, seguras y versionadas para los dispositivos, posiciones, viajes, alertas, informes y conductores de su flota, con webhooks firmados, un SDK de TypeScript y un sandbox.
- REST y OpenAPI
- Webhooks firmados
- SDK de TypeScript
- Sandbox con vehículos simulados
1const api = 'https://api.syncvelo.com';2const { SYNCVELO_CLIENT_ID: id, SYNCVELO_CLIENT_SECRET: secret, SYNCVELO_ORG: org } = process.env;3 4const { access_token } = await fetch(`${api}/oauth/token`, {5 method: 'POST',6 headers: { Authorization: `Basic ${btoa(`${id}:${secret}`)}` },7 body: new URLSearchParams({ grant_type: 'client_credentials' }),8}).then((r) => r.json());9 10// Cursor pagination: follow next_cursor until it is null11let cursor: string | null = null;12do {13 const url = new URL(`${api}/v1/tenants/${org}/devices?limit=100`);14 if (cursor) url.searchParams.set('cursor', cursor);15 const page = await fetch(url, { headers: { Authorization: `Bearer ${access_token}` } }).then((r) => r.json());16 for (const d of page.items) console.log(d.id, d.status, d.latitude, d.longitude, d.speed_kph);17 cursor = page.next_cursor;18} while (cursor);Superficies
Todas las formas de conectarse, con controles integrados
Cada superficie está diseñada con autorización, multitenencia y auditabilidad desde el primer día.
REST público y OpenAPI
Dispositivos, posiciones, viajes, geocercas, reglas, alertas, informes y conductores, con paginación por cursor y versiones explícitas.
Controles: Credenciales de cliente OAuth2, alcances, límites de tasa y cuotas diarias.
Webhooks de eventos
Alertas, entradas y salidas de geocercas y viajes completados, firmados, reintentados con espera progresiva y reenviables.
Controles: Rotación de secretos sin perder eventos; una organización por cliente.
SDK de TypeScript
Un cliente tipado generado a partir del documento OpenAPI; sigue los cursores y solo reintenta cuando es seguro.
Controles: Versionado semántico y pruebas de compatibilidad.
Sandbox
Una organización aparte con vehículos simulados, viajes de ejemplo y webhooks de prueba, que se restablece cuando lo pida.
Controles: Aislada en la raíz: sin organización padre ni acceso a datos reales.
Página de desarrolladores en la consola
Clientes de API, alcances y endpoints de webhooks, gestionados por el propietario de la organización, con la referencia de la API.
Controles: Los secretos se muestran una vez y solo se guardan como huellas.
Reenvío y MQTT
Reenvío a otras plataformas y servidores gubernamentales, y MQTT para integradores. Previsto (X5).
Controles: No disponible hoy.
REST y OpenAPI
APIs predecibles que respetan a sus tenants
Endpoints orientados a recursos con paginación por cursor, filtros, claves de idempotencia y versiones explícitas. Cada solicitud aplica la política completa del tenant.
- Credenciales de cliente OAuth2 con alcances granulares
- IDs canónicos de SyncVelo, nunca claves internas del motor
- Claves de idempotencia y reintentos seguros en escrituras
- Límites de tasa y cuotas diarias por cliente
1const api = 'https://api.syncvelo.com';2const { SYNCVELO_CLIENT_ID: id, SYNCVELO_CLIENT_SECRET: secret, SYNCVELO_ORG: org } = process.env;3 4const { access_token } = await fetch(`${api}/oauth/token`, {5 method: 'POST',6 headers: { Authorization: `Basic ${btoa(`${id}:${secret}`)}` },7 body: new URLSearchParams({ grant_type: 'client_credentials' }),8}).then((r) => r.json());9 10// Cursor pagination: follow next_cursor until it is null11let cursor: string | null = null;12do {13 const url = new URL(`${api}/v1/tenants/${org}/devices?limit=100`);14 if (cursor) url.searchParams.set('cursor', cursor);15 const page = await fetch(url, { headers: { Authorization: `Bearer ${access_token}` } }).then((r) => r.json());16 for (const d of page.items) console.log(d.id, d.status, d.latitude, d.longitude, d.speed_kph);17 cursor = page.next_cursor;18} while (cursor);Webhooks
Eventos en tiempo real, entregados de forma confiable
Suscríbase a alertas (abiertas, finalizadas, confirmadas, cerradas), entradas y salidas de geocercas y viajes completados. Cada entrega va firmada, se reintenta con espera progresiva y puede reenviarse durante 30 días.
- Payloads firmados con HMAC y tolerancia de marca de tiempo
- Reintentos automáticos, cola de mensajes fallidos y reenvío
- Un catálogo de eventos versionado en el documento OpenAPI
- Registros de entrega en la consola y mediante la API
1POST /your/webhook2webhook-id: 6f0c2d2e-1b55-8a4e-9c3f-8f9a2b7d1e403webhook-timestamp: 17923164674webhook-signature: v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=5 6{7 "id": "6f0c2d2e-1b55-8a4e-9c3f-8f9a2b7d1e40",8 "type": "geofence.exited",9 "schema_version": "1.0",10 "organization_id": "1f7c…",11 "occurred_at": "2026-10-19T09:41:07.000Z",12 "created_at": "2026-10-19T09:41:08.214Z",13 "data": { "device_id": "8d2a…", "geofence_id": "c41e…" }14}SDK
Un cliente tipado de TypeScript, y REST sencillo para todo lo demás
El SDK de TypeScript se genera a partir del documento OpenAPI y se comparte con el acceso al sandbox; aún no está en un registro público. Los demás lenguajes llaman directamente a la API REST.
TypeScript
Para servidores: Node.js 20+, Deno, Bun y entornos edge. Métodos tipados, cursores automáticos, reintentos seguros y verificación de webhooks.
import { SyncVelo } from '@syncvelo/sdk'Cualquier otro lenguaje
Python, Java, Go o cualquier cosa que hable HTTPS: use la API REST y el documento OpenAPI, como en los ejemplos de arriba.
GET https://api.syncvelo.com/openapi.json
Ciclo de vida de la integración
De la primera API key a producción, con gobierno de punta a punta
- 01
Registrar
Un propietario crea un cliente de API en la página de desarrolladores de la consola, solo con los alcances que necesita.
- 02
Autorizar
El cliente cambia su ID y su secreto por un token de acceso de corta duración (credenciales de cliente OAuth2).
- 03
Suscribirse
Registre endpoints de webhooks, envíe eventos de prueba y pruébelo todo antes en el sandbox.
- 04
Operar
Cuotas, idempotencia, reintentos y política completa del tenant en cada solicitud.
- 05
Observar
Registros de entrega, reenvío de entregas fallidas, rotación y revocación de secretos.
Sandbox para desarrolladores
Comience a desarrollar hoy
Obtenga un tenant de sandbox con dispositivos simulados, viajes de ejemplo y webhooks de prueba. Actualmente, el acceso para desarrolladores está disponible para partners e integradores piloto.
Los ejemplos de código de esta página son ilustrativos. La referencia completa de la API se comparte junto con el acceso al sandbox.
Comenzar
¿Todo listo para mover su mundo de forma más inteligente?
Descubra cómo SyncVelo puede impulsar su flota, su negocio como partner o su próxima integración. Recorrido personalizado, dispositivos reales y su propio caso de uso.