Aller au contenu
Logo FleeteeLogo Fleetee

À quoi sert l’API Fleetee, et que permet-elle ?

  • API v3
  • Administrateur

En bref. 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.

Une API est une porte d’entrée réservée aux logiciels. Là où vous cliquez dans Manager, un autre programme envoie une requête à Fleetee, avec l’autorisation de votre clé. Il lit ou écrit les mêmes données que vous.

Ce qu’elle permet

L’API v3 de Fleetee couvre :

  • les locations : les lister, en créer, les modifier, les accepter, les confirmer, marquer le départ et le retour, les annuler, remplacer un véhicule ;
  • les devis : créer, modifier, convertir en location, envoyer, télécharger le PDF ;
  • la disponibilité et les prix : ce qui est libre sur une période et ce que coûterait une location, sans rien créer ;
  • les véhicules (et leurs indisponibilités) et le catalogue : agences, catégories, options, packs, franchises, forfaits kilométriques, codes promo ;
  • les tarifs : grilles, saisons, prix ;
  • les clients et leurs permis ;
  • les factures et avoirs (en lecture) et les paiements ;
  • les états des lieux et les avis (en lecture) ;
  • les webhooks : l’inscription d’un outil aux événements de Fleetee.

À quoi cela sert, concrètement

  • Afficher vos véhicules et vos prix sur votre propre site, et y prendre des réservations.
  • Faire arriver chaque location et chaque paiement dans votre logiciel comptable ou de caisse.
  • Brancher un partenaire (télématique, assurance, tableau de bord) sur vos données.
  • Alimenter un outil sans code (Zapier, Make, n8n) : voir Comment relier Fleetee à Zapier, Make ou n8n ?.

Ce qu’elle ne fait pas

  • Elle ne synchronise rien toute seule. Elle répond quand on l’interroge. Pour être prévenu quand quelque chose se passe, utilisez les webhooks : voir Comment prévenir mes outils dès qu’une location est confirmée ?.
  • Elle ne vide pas votre compte. Une location ne se supprime pas par l’API : elle s’annule. Un client ne se supprime que s’il n’a ni location, ni devis, ni facture. Les seules suppressions proposées portent sur des éléments précis (une indisponibilité, une saison, un permis, un webhook). Une clé en lecture seule ne supprime rien du tout.
  • Elle ne remplace pas l’interface : certains réglages restent dans Manager.

Ce qu’il faut pour l’utiliser

L’API n’a pas de prix séparé : voir Combien coûte l’accès à l’API ?.

  1. Une clé d’API créée par l’administrateur : voir Comment créer mes clés d’API ?. Elle se compose d’une clé et d’un secret, envoyés dans deux en-têtes (x-api-key et secret-key).
  2. Quelqu’un qui sait construire la requête : voir Faut-il être développeur pour utiliser l’API ?.

La clé donne accès aux données de vos clients (nom, e-mail, permis). Créez une clé par usage, en lecture seule dès que l’outil ne fait que lire : voir Comment limiter une clé à certaines agences ou à la lecture seule ?.

Cet article vous a aidé ?

Écrire au support

Demander à l’assistant : « … »bientôt