Développeurs
API B2B
Connectez votre site, votre conciergerie d'hôtel ou votre outil interne à votre flotte : estimation de prix ferme, création de courses envoyées directement au dispatch, suivi temps réel et synchronisation de vos clients.
Authentification
Chaque flotte possède sa propre clé API, visible dans son cockpit (page Paramètres). Elle ne donne accès qu'aux données de votre flotte — jamais à celles des autres. Passez-la dans le header X-Api-Key de chaque requête, toujours côté serveur (jamais dans le code d'une page web publique, sinon n'importe qui pourrait la lire et créer des courses en votre nom).
curl https://www.dispatcheo.com/api/v1/catalog \ -H "X-Api-Key: deo_live_votre_cle"
Bac à sable de démonstration
Pour essayer sans compte, la clé deo_live_demo_7k2p pointe vers la flotte de démonstration Onyx VTC. Elle est partagée et réinitialisée régulièrement : n'y mettez aucune donnée réelle. Elle est limitée à 3 écritures par minute (les vraies clés n'ont pas cette restriction).
Points d'accès
POST
Estimation de prix ferme
Calcule un prix ferme avec la grille tarifaire de votre flotte (km, minute, forfaits zones, majorations nuit/dimanche/férié, TVA VTC).
POST /api/v1/estimate
{ "pickup": "CDG Terminal 2E", "dropoff": "Opéra, Paris",
"pickupAt": "2026-09-01T14:30:00Z", "vehicleType": "sedan" }
→ { "priceHt": 75, "priceTtc": 82.5, "vatRate": 0.1,
"distanceKm": 28, "durationMin": 42 }POST
Créer une course
Crée une course dans votre cockpit : elle entre dans le dispatch comme une réservation normale et est proposée au meilleur chauffeur.
POST /api/v1/rides
{ "pickup": "Hôtel Lutetia", "dropoff": "Orly 4",
"pickupAt": "2026-09-01T09:00:00Z", "clientEmail": "client@exemple.fr" }
→ { "id": "rid_..." }GET
Lister et suivre les courses
Liste vos courses avec statut, prix et lien de suivi temps réel. Le lien /suivi/:token s'intègre aussi en iframe (/embed/suivi/:token).
GET /api/v1/rides
→ { "rides": [ { "id": "rid_...", "status": "assigned",
"pickup": "CDG T2E", "dropoff": "Opéra", "priceTtc": 82.5,
"tracking": "/suivi/trk_..." } ] }GET
Catalogue tarifaire
Vos gammes de véhicules, tarifs, zones et forfaits fixes — utile pour afficher vos prix sur un site partenaire.
GET /api/v1/catalog
→ { "vehicleTypes": [...], "zones": [...], "fixedFares": [...] }GET / POST
Clients CRM
Synchronisez vos clients depuis un autre outil : lecture de la liste et création (déduplication automatique par email).
POST /api/v1/clients
{ "name": "Hôtel Bakoua", "email": "resa@bakoua.mq",
"companyName": "Hôtel Bakoua", "phone": "+596..." }
→ { "id": "cli_..." }Limites et erreurs
401— clé manquante ou invalide (headerX-Api-Key).429— limite de 60 requêtes par minute et par clé dépassée. Attendez une minute et réessayez.400— corps de requête invalide (le message d'erreur précise le champ manquant).
Si votre clé fuite, contactez-nous pour la régénérer immédiatement : l'ancienne clé cesse de fonctionner.
Un projet d'intégration ?
Volumes importants, webhook à la fin de course, champ manquant dans une réponse : écrivez-nous, on adapte l'API avec les premiers partenaires.