API City Cube
Automatisez vos livraisons avec notre API RESTful
Intégration partenaires
Une API d'intégration, ouverte sur demande
City Cube propose une API d'intégration aux partenaires qui souhaitent créer et suivre leurs courses depuis leur propre système. L'accès n'est pas ouvert en libre-service : il se demande, et nous en définissons ensemble le périmètre.
Si vous n'avez pas de système à connecter, le compte entreprise couvre déjà la réservation régulière et la facturation mensuelle.
Périmètre
Ce que vous pouvez automatiser
Trois usages couvrent la majorité des intégrations demandées par nos partenaires.
Création de réservation
Envoyez une course depuis votre back-office ou votre boutique en ligne : adresses, date souhaitée et type de véhicule.
Suivi de statut
Interrogez l'état d'une course, de l'attribution du chauffeur au déchargement, pour l'afficher dans votre propre interface.
Notifications
Recevez les changements d'état pour prévenir votre client final au bon moment, sans surveiller la course manuellement.
Mise en place
Comment se déroule une intégration
Le parcours est le même pour tous les partenaires, quelle que soit la technologie de votre côté.
-
1
Demande d'accès
Présentez-nous votre besoin et le volume attendu via la page contact. Nous vérifions que l'API répond bien à votre cas.
-
2
Clés et documentation
Nous vous transmettons vos identifiants d'accès et la documentation des points d'entrée disponibles pour votre intégration.
-
3
Mise en production
Après vos tests, nous validons ensemble les premières courses réelles et l'intégration passe en production.
Exemple indicatif d'appel
La forme exacte des champs est précisée dans la documentation remise avec vos clés. Cet exemple illustre simplement la création d'une réservation.
POST /api/v1/partner/bookings
{
"pickup": "12 rue de Rivoli, 75004 Paris",
"dropoff": "8 avenue Jean Jaures, 93000 Bobigny",
"date": "2026-03-14T09:30:00+01:00",
"vehicle_type": "camionnette_12m3"
}Questions fréquentes
Avant de nous écrire
- Comment l'authentification fonctionne-t-elle
- Chaque partenaire reçoit une clé qui lui est propre et l'envoie à chaque appel. La clé est liée à votre compte, révocable et remplaçable à votre demande.
- Existe-t-il un environnement de test
- Oui : nous ouvrons un accès de test avant la production, afin que vous puissiez créer des courses fictives sans déclencher de transport réel.
- L'accès à l'API est-il facturé
- Vous payez les courses, pas les appels. Les conditions tarifaires sont fixées avec votre compte entreprise lors de la demande d'accès.
Demandez un accès API
Expliquez-nous ce que vous voulez automatiser et depuis quel outil : nous vous répondons avec le périmètre possible et la marche à suivre.