L'API d'ingestion caméras
C'est sans doute l'API la plus stratégique de la plateforme. Elle permet à n'importe quel device (caméra MDVR Streamax, Howen, Jimi, Coban, ou même un Raspberry Pi custom) d'envoyer ses données à Transtek.
5 endpoints, tous authentifiés par un `Authorization: Bearer dev_<token>` (token généré par l'admin sur `/app/admin/cameras`) :
``` POST /api/ingest/cameras/heartbeat → ping toutes les 30s POST /api/ingest/cameras/positions → batch GPS jusqu'à 120 points POST /api/ingest/cameras/events → batch événements ADAS/DSM (max 32) POST /api/ingest/cameras/clips/upload-url → presigned PUT vers R2 POST /api/ingest/cameras/clips/finalize → confirme l'upload du clip ```
Documentation complète, exemples curl, taxonomie des événements, et guides d'intégration vendor sont publiés sur /docs/cameras-api.md (lien public).
Adaptateur Streamax CMSV6 prêt à l'emploi
Pour les flottes équipées de MDVR Streamax CMSV6 (la marque la plus répandue en Afrique de l'Ouest), nous fournissons un adaptateur de référence open-source qui reçoit les webhooks Streamax, les traduit dans notre taxonomie, et les forwarde à l'API Transtek. Forkable en 1 heure pour Howen, Jimi, Coban : seul le mapping des codes d'alarme change.
Webhooks sortants
Pour synchroniser votre SI avec ce qui se passe dans Transtek, configurez un webhook entrant chez vous + l'URL dans `/app/admin/notifications`. Vous recevrez un POST signé HMAC-SHA256 sur chaque alerte HIGH/CRITICAL :
```json POST /your/webhook/url Content-Type: application/json X-Transtek-Signature: sha256=<hex>
{ "id": "clx...", "type": "FATIGUE", "severity": "CRITICAL", "message": "Somnolence détectée", "vehicle": { "code": "TR-001", "plate": "RB 1234" }, "driver": { "name": "Foo Bar" }, "links": { "vehicle": "https://transtekbj.com/app/cameras/...", "clip": "https://transtekbj.com/api/clips/.../playback" } } ```
Compatible Slack, Microsoft Teams, Discord, ou tout endpoint custom. Code de vérification HMAC fourni en Node.js (Express) et Python (Flask) dans la doc.
API REST plateforme (lecture)
Pour lire les données de votre flotte depuis votre SI, ERP, BI :
- `GET /api/v1/vehicles` — liste, statuts, dernière position
- `GET /api/v1/missions` — missions par statut/période
- `GET /api/v1/alerts` — alertes ouvertes/résolues
- `GET /api/v1/orders` — commandes boutique
- `GET /api/v1/reports/{slug}` — rapports prédéfinis en JSON
Toutes les routes supportent pagination (`?limit=50&offset=100`), filtrage (`?status=IN_PROGRESS`), et tri (`?sort=-createdAt`). Documentation OpenAPI 3.0 disponible.
Connecteurs ERP préconfigurés
Bridges no-code disponibles dans le marketplace Transtek :
- Odoo Community 17+ : sync véhicules, missions, factures de commande
- SAP Business One / S4 : maps standards Transtek → tables SAP
- Microsoft Dynamics 365 : connecteur Power Platform certifié
- Sage 50 : export CSV scheduled
- Tally ERP : webhook listener side de Tally
Si votre ERP n'est pas listé, l'API REST + les webhooks couvrent 99 % des intégrations en quelques jours d'effort.
Sandbox développeur
Compte sandbox gratuit avec :
- Tenant fictif avec 50 véhicules, 30 conducteurs, 200 missions générées
- Tokens de test (sans coût)
- Webhooks de test pour valider votre receveur
- Rate limiting plus permissif
Demandez via votre Account Manager ou par email à dev@transtekbj.com.
SLA
- API uptime : 99,9 % (SLA contractuel sur les plans Pro et Enterprise)
- Latence p95 : < 300 ms (Cotonou → Frankfurt eu-central-1)
- Rate limits : 1 000 req/min/caméra sur l'ingestion ; 100 req/min/utilisateur sur l'API lecture (configurable Enterprise)