Developer Ecosystem
Gestalten Sie die Zukunft der Mobilität auf SyncVelo
Offene, sichere und versionierte Schnittstellen für Geräte, Positionen, Fahrten, Alarme, Berichte und Fahrer Ihrer Flotte, mit signierten Webhooks, einem TypeScript-SDK und einer Sandbox.
- REST & OpenAPI
- Signierte Webhooks
- TypeScript-SDK
- Sandbox mit simulierten Fahrzeugen
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);Schnittstellen
Jeder Weg der Anbindung – mit eingebauten Kontrollen
Jede Schnittstelle ist vom ersten Tag an auf Autorisierung, Mandantenfähigkeit und Prüfbarkeit ausgelegt.
Öffentliche REST-API & OpenAPI
Geräte, Positionen, Fahrten, Geofences, Regeln, Alarme, Berichte und Fahrer, mit Cursor-Paginierung und expliziten Versionen.
Kontrollen: OAuth2 Client Credentials, Scopes, Ratenlimits und Tageskontingente.
Event-Webhooks
Alarme, Ein- und Ausfahrten an Geofences und abgeschlossene Fahrten, signiert, mit Backoff wiederholt und erneut zustellbar.
Kontrollen: Secret-Rotation ohne verlorene Ereignisse; eine Organisation je Client.
TypeScript-SDK
Ein typisierter Client, generiert aus dem OpenAPI-Dokument; er folgt Cursorn und wiederholt nur, wo es sicher ist.
Kontrollen: Semantische Versionierung und Kompatibilitätstests.
Sandbox
Eine eigene Organisation mit simulierten Fahrzeugen, Beispielfahrten und Test-Webhooks, auf Wunsch zurückgesetzt.
Kontrollen: An der Wurzel isoliert: keine übergeordnete Organisation, kein Zugriff auf echte Daten.
Entwicklerseite in der Konsole
API-Clients, Scopes und Webhook-Endpunkte, verwaltet vom Inhaber der Organisation, mit der API-Referenz.
Kontrollen: Secrets werden einmal angezeigt und nur als Fingerabdruck gespeichert.
Weiterleitung und MQTT
Weiterleitung an andere Plattformen und Behördenserver sowie MQTT für Integratoren. Geplant (X5).
Kontrollen: Heute nicht verfügbar.
REST & OpenAPI
Berechenbare APIs, die Ihre Mandanten respektieren
Ressourcenorientierte Endpunkte mit Cursor-Paginierung, Filtern, Idempotenzschlüsseln und expliziten Versionen. Jede Anfrage unterliegt der vollständigen Mandantenrichtlinie.
- OAuth2 Client Credentials mit fein abgestuften Scopes
- Kanonische SyncVelo-IDs, niemals interne Engine-Schlüssel
- Idempotenzschlüssel und sichere Wiederholungen bei Schreibvorgängen
- Ratenlimits und Tageskontingente pro Client
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
Echtzeit-Events, zuverlässig zugestellt
Abonnieren Sie Alarme (geöffnet, beendet, bestätigt, geschlossen), Ein- und Ausfahrten an Geofences und abgeschlossene Fahrten. Jede Zustellung ist signiert, wird mit Backoff wiederholt und lässt sich 30 Tage lang erneut senden.
- HMAC-signierte Payloads mit Zeitstempel-Toleranz
- Automatische Wiederholungen, Dead-Letter-Queue und Replay
- Ein versionierter Event-Katalog im OpenAPI-Dokument
- Zustellprotokolle in der Konsole und über die 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
Ein typisierter TypeScript-Client, und schlichtes REST für alles andere
Das TypeScript-SDK wird aus dem OpenAPI-Dokument generiert und mit dem Sandbox-Zugang bereitgestellt; in einer öffentlichen Registry ist es noch nicht. Andere Sprachen rufen die REST-API direkt auf.
TypeScript
Für Server: Node.js 20+, Deno, Bun und Edge-Runtimes. Typisierte Methoden, Cursor automatisch, sichere Wiederholungen und Webhook-Prüfung.
import { SyncVelo } from '@syncvelo/sdk'Jede andere Sprache
Python, Java, Go oder alles, was HTTPS spricht: Nutzen Sie die REST-API und das OpenAPI-Dokument, wie in den Beispielen oben.
GET https://api.syncvelo.com/openapi.json
Integrations-Lebenszyklus
Vom ersten API-Schlüssel bis zur Produktion – durchgängig kontrolliert
- 01
Registrieren
Ein Inhaber legt auf der Entwicklerseite der Konsole einen API-Client an, nur mit den Scopes, die er braucht.
- 02
Autorisieren
Der Client tauscht ID und Secret gegen ein kurzlebiges Zugriffstoken (OAuth2 Client Credentials).
- 03
Abonnieren
Webhook-Endpunkte registrieren, Test-Ereignisse senden und alles zuerst in der Sandbox ausprobieren.
- 04
Betreiben
Kontingente, Idempotenz, Wiederholungen und vollständige Mandantenrichtlinie bei jeder Anfrage.
- 05
Beobachten
Zustellprotokolle, erneutes Senden fehlgeschlagener Zustellungen, Secret-Rotation und Widerruf.
Entwickler-Sandbox
Starten Sie noch heute
Erhalten Sie einen Sandbox-Mandanten mit simulierten Geräten, Beispielfahrten und Test-Webhooks. Der Entwicklerzugang steht derzeit Pilotpartnern und Integratoren zur Verfügung.
Die Codebeispiele auf dieser Seite dienen der Veranschaulichung. Die vollständige API-Referenz erhalten Sie mit dem Sandbox-Zugang.
Loslegen
Bereit, Ihre Welt smarter zu bewegen?
Erleben Sie, wie SyncVelo Ihre Flotte, Ihr Partnergeschäft oder Ihre nächste Integration voranbringt. Persönliche Führung, echte Geräte, Ihr Anwendungsfall.