L'API Floweet permet à votre serveur de lire les prix carburant de la semaine et le classement des enseignes, les stations-service et les bornes de recharge, l'annuaire SIRENE des entreprises avec l'estimation de leur flotte, de chiffrer le surcoût carburant et carbone d'une flotte, et de travailler avec les prospects et les simulations de votre organisation. Pensée pour les émetteurs de cartes carburant, les réseaux de stations, les gestionnaires de flotte et leurs éditeurs de logiciels. Chaque exemple existe en curl, JavaScript et Python.
En bref
- Une API REST en JSON, à l'adresse
https://api.floweet.com/v1: 21 opérations sous 10 scopes. - Une clé d'API par organisation, qui agit au nom d'un membre ADMIN désigné : elle voit exactement ce que ce membre voit, avec l'offre de l'organisation (authentification).
- Un bac à sable (
fw_test_) sur les mêmes données, où l'argumentaire est rédigé au gabarit, sans IA (bac à sable). - Les standards du web : pagination par curseur,
Idempotency-Key, en-têtesRateLimit-*(120 requêtes par minute), erreurs à code stable. - Accès sur demande, ouvert par notre équipe : contact@floweet.com. L'API est en bêta.
Premier appel
curl "https://api.floweet.com/v1/barometer?fuel=gazole" \
-H "Authorization: Bearer $FLOWEET_API_KEY"Démarrer
- Démarrage rapideObtenez une clé de bac à sable, lisez le baromètre, chiffrez le surcoût d'une flotte et enregistrez un prospect, en curl, JavaScript ou Python.
- Authentification et clésClés fw_test_ et fw_live_, en-tête Authorization Bearer, membre de l'organisation au nom duquel la clé agit, révocation et erreurs d'authentification.
- Bac à sableClés fw_test_ : mêmes données, argumentaires rédigés au gabarit sans IA, 1 000 appels par jour, puis passage en production avec une clé fw_live_.
- ScopesLes 10 scopes de l'API Floweet (barometer:read, prospects:write…), les opérations que chacun ouvre et l'erreur 403 insufficient_scope.
- ConventionsJSON en camelCase, prix en millièmes d'euro par litre, montants en centimes, dates ISO 8601, statuts HTTP, en-têtes des réponses et sources des données.
Ressources
- BaromètreLe classement des enseignes par prix moyen, en France et dans ses 13 régions, pour cinq carburants, avec ou sans autoroutes, recalculé toutes les 30 min.
- Stations carburantLes stations-service de France et d'Europe : prix par carburant, services, horaires, accès poids lourds, et les dix moins chères d'un département.
- Bornes de rechargeLes bornes de recharge publiques du fichier IRVE : réseau, puissance, prises, gratuité, paiement par carte et points de charge, filtrables par vitesse.
- EntreprisesRechercher un établissement par nom, SIREN ou SIRET, lire son unité légale, son activité, son réseau d'enseigne et l'estimation de sa flotte de véhicules.
- Coût d'une flotteLe surcoût annuel à la pompe d'une flotte par type de véhicule, comparé à l'enseigne la moins chère, et son coût carbone ETS2 à partir de 2028.
- ProspectsEnregistrer les flottes de vos prospects avec leur surcoût carburant et carbone recalculé sur les prix de la semaine : créer, lire, remplacer, supprimer.
- SimulationsSimuler la couverture de votre réseau autour d'un client, suivre l'avancement commercial et rédiger l'argumentaire de vente, par l'IA ou au gabarit.
- Géocodage et itinérairesTrouver les coordonnées d'une adresse (Base Adresse Nationale, puis OpenStreetMap) et calculer un itinéraire routier de 2 à 25 points, distance et durée.
Protocole
- PaginationLes listes répondent { data, nextCursor, hasMore } : comment passer d'une page à l'autre, lire une liste entière et ce que renvoient les recherches.
- IdempotenceL'en-tête Idempotency-Key rend chaque POST rejouable sans doublon pendant 24 heures : rejeu, requête en cours, clé réutilisée et nouvelles tentatives.
- Limites de débit120 requêtes par minute et par organisation, 30 pour la géo, 1 000 par jour en bac à sable : en-têtes RateLimit-*, erreur 429 et Retry-After.
- ErreursUne seule forme d'erreur { error: { code, message, details } }, la table de tous les codes avec leur statut HTTP, et quand réessayer une requête.
- Offres et IAUne clé agit avec le plan de son organisation : modules réservés (erreur plan_required), argumentaire rédigé par l'IA avec une clé live, au gabarit sinon.
Versions
- Versions et compatibilitéCe qui peut changer dans /v1 et ce qui ne change jamais, l'en-tête Floweet-Version, la bêta, et 12 mois de coexistence avec une future /v2.
- Journal des changementsChaque version du contrat public /v1 de l'API Floweet, datée : nouvelles opérations, nouveaux scopes, nouveaux codes d'erreur et nouveaux en-têtes.
La référence, servie par l'API
Cette documentation et la référence sont générées depuis le même contrat que celui avec lequel l'API valide vos requêtes. La référence reste disponible en appoint :
- Référence interactive — chaque opération, essayable dans le navigateur (Scalar).
- Contrat OpenAPI 3.1 — pour générer un client typé dans votre langage.
En préparation
- Espace développeur en libre-serviceBientôt — créer, nommer et révoquer vos clés, suivre votre consommation, demander la production vous-même. Aujourd'hui, notre équipe le fait pour vous, par e-mail.
- Webhooks sortantsBientôt — être prévenu d'un changement de prix ou de l'avancement d'une simulation au lieu d'interroger l'API.
- Serveur MCPBientôt — les mêmes opérations, exposées aux assistants IA, avec les mêmes scopes.
- Accès inclus dans les offresBientôt — ouvrir l'API depuis votre abonnement, sans demande, avec un forfait d'appels.