Fleetee API
Relier vos outils à Fleetee par l’API.
15 articles
Type d’article
Comment faire (5)
Une tâche, pas à pas.
- Comment créer mes clés d’API ?Dans Réglages › Clés d’API, cliquez sur « Créer une clé », donnez-lui un nom, choisissez son accès (lecture seule ou lecture et écriture), l’API v3 et les agences. La clé et son secret ne s’affichent qu’une fois : copiez-les.VidéoCaptures
- Que faire si une clé d’API est perdue ou exposée ?Dans Réglages › Clés d’API : secret perdu, renouvelez-le (« Renouveler le secret » laisse 24 heures à votre outil, « Renouveler maintenant » coupe l’ancien tout de suite) ; clé perdue ou exposée, révoquez-la (« Révoquer ») et créez-en une autre.
- Comment prévenir mes outils dès qu’une location est confirmée ?Dans Réglages › Webhooks, cliquez sur « Ajouter un webhook », donnez l’adresse que fournit votre outil, cochez « Une location est confirmée », puis envoyez un essai. Fleetee y envoie chaque événement choisi, signé, et réessaie en cas d’échec.VidéoCaptures
- Comment limiter une clé à certaines agences ou à la lecture seule ?Dans Réglages › Clés d’API, cliquez sur « Modifier » sur la ligne de la clé : choisissez « Lecture seule » comme accès et cochez les agences dans « Limiter à certaines agences ». Seul ce qui change est enregistré, et la restriction s’applique tout de suite.
- Comment relier Fleetee à Zapier, Make ou n8n ?Dans votre outil, créez un déclencheur « webhook » pour obtenir une adresse, puis collez-la dans Réglages › Webhooks de Fleetee et cochez les événements. Pour que l’outil lise ou écrive dans Fleetee, créez une clé dans Réglages › Clés d’API.
Comprendre (8)
Une notion, expliquée simplement.
- À quoi sert l’API Fleetee, et que permet-elle ?L’API Fleetee est la porte par laquelle un logiciel lit et écrit vos données à votre place : locations, devis, clients, véhicules, tarifs, factures, paiements. Elle ne fait rien seule : c’est un outil, ou un développeur, qui l’appelle avec vos clés.
- API ou module de réservation : lequel me faut-il ?Le module de réservation est un parcours tout fait, qui s’affiche sur votre site Fleetee ou sur un site externe, sans développement ni clé. L’API sert à construire un parcours ou une intégration sur mesure. Les deux peuvent coexister.
- Faut-il être développeur pour utiliser l’API ?Pour appeler l’API directement, oui : il faut écrire des requêtes, dans n’importe quel langage (elle parle HTTP et JSON). Sans développeur, Zapier, Make ou n8n couvrent les cas simples, avec les webhooks de Fleetee.
- Qu’est-ce que l’API v3, et faut-il quitter l’ancienne API ?L’API v3 est la version actuelle, à choisir pour toute nouvelle intégration. L’ancienne API (v1) continue de fonctionner à l’identique, à côté : une clé peut ouvrir les deux, et vous migrez ressource par ressource, sans coupure.
- Comment éviter les doublons de clients ou de réservations par l’API ?Envoyez un en-tête « Idempotency-Key » sur chaque création, donnez votre propre référence de location, et laissez la règle des clients (même e-mail = même client) jouer. Un renvoi avec la même clé redonne la première réponse, sans rien créer.
- Que prévoir dans l’API pour un réseau de plusieurs agences ?Chaque location, prix et disponibilité dépend d’une agence. Prévoyez une clé par périmètre d’agences, partez de la liste des agences, ne comptez pas sur une agence hors de la clé, et utilisez la demande de rattachement pour un client d’une autre agence.
- Puis-je déclencher ou encaisser des paiements par l’API ?Vous pouvez enregistrer un paiement reçu ailleurs et créer un lien de paiement que le client règle en ligne. L’API ne débite pas une carte à votre place et n’enregistre pas de remboursement. Les deux envois exigent un « Idempotency-Key ».
- Combien coûte l’accès à l’API ?L’API n’a pas de prix à part dans la grille de Fleetee. La page Tarifs la range dans Fleetee Web : « API pour relier votre propre système de réservation ». Fleetee Full comprend Fleetee Web. Les clés se créent dans Réglages › Clés d’API.
Dépannage (2)
Quand quelque chose ne marche pas : les causes une par une.
- Pourquoi une liste de l’API ne contient-elle pas tous mes résultats ?Une liste est découpée en pages : 25 résultats par défaut, 100 au plus. Suivez « next_cursor » jusqu’à ce qu’il soit vide. Si des résultats manquent encore, vérifiez les filtres, les agences de la clé, puis les limites d’appels (429).
- Que veulent dire les erreurs les plus courantes de l’API ?Chaque erreur de l’API v3 porte un « code » stable et un statut HTTP : 401 la clé, 403 les droits, 404 l’objet, 409 un conflit, 422 un champ invalide, 429 trop d’appels. Lisez le « code », puis donnez le « request_id » au support si besoin.