En quelques minutes : une clé de bac à sable, le baromètre des prix de la semaine, le surcoût d'une flotte chiffré, un prospect enregistré, puis une entreprise trouvée dans l'annuaire SIRENE. Chaque exemple existe en curl, JavaScript et Python ; le langage choisi vaut pour toute la page.
1. Obtenez une clé de bac à sable
L'accès à l'API s'ouvre sur demande, organisation par organisation. Écrivez à contact@floweet.com en indiquant votre organisation Floweet, le membre ADMIN au nom duquel l'intégration agira, et ce que vous souhaitez construire. Notre équipe ouvre le compte d'API de votre organisation et vous remet une clé fw_test_….
Elle ne s'affiche qu'une fois : rangez-la aussitôt dans une variable d'environnement de votre serveur.
export FLOWEET_API_KEY="fw_test_…"2. Lisez le baromètre
Premier appel : le classement des enseignes par prix moyen du gazole, en France et dans chaque région, autoroutes comprises ou non. Les prix sont des entiers en millièmes d'euro par litre : 2252 vaut 2,252 €/L.
/v1/barometerScope barometer:readcurl "https://api.floweet.com/v1/barometer?fuel=gazole" \
-H "Authorization: Bearer $FLOWEET_API_KEY"{
"fuel": "gazole",
"generatedAt": "2026-10-26T11:34:49.346Z",
"pricesFrom": "2026-10-19T11:35:43.000Z",
"pricesTo": "2026-10-26T11:00:00.000Z",
"national": {
"all": {
"brands": [
{
"brand": "Total Access",
"averagePrice": 2252,
"stations": 231,
"others": false
},
{
"brand": "TotalEnergies",
"averagePrice": 2253,
"stations": 837,
"others": false
},
{
"brand": "Netto",
"averagePrice": 2375,
"stations": 60,
"others": false
}
],
"stations": 6391,
"terciles": [
2359,
2399
]
},
"excludingHighways": {
"brands": [
{
"brand": "Total Access",
"averagePrice": 2252,
"stations": 219,
"others": false
},
{
"brand": "TotalEnergies",
"averagePrice": 2252,
"stations": 743,
"others": false
},
{
"brand": "Netto",
"averagePrice": 2375,
"stations": 60,
"others": false
}
],
"stations": 6024,
"terciles": [
2359,
2398
]
}
},
"regions": [
{
"code": "11",
"slug": "ile-de-france",
"name": "Île-de-France",
"all": {
"brands": [
{
"brand": "Total Access",
"averagePrice": 2250,
"stations": 55,
"others": false
},
{
"brand": "TotalEnergies",
"averagePrice": 2250,
"stations": 174,
"others": false
}
],
"stations": 644,
"terciles": [
2250,
2410
]
},
"excludingHighways": {
"brands": [
{
"brand": "Total Access",
"averagePrice": 2250,
"stations": 55,
"others": false
},
{
"brand": "TotalEnergies",
"averagePrice": 2250,
"stations": 156,
"others": false
}
],
"stations": 610,
"terciles": [
2250,
2409
]
}
}
]
}3. Chiffrez le surcoût d'une flotte
Décrivez la flotte (enseigne utilisée, kilométrage, véhicules par type et consommation) : l'API rend le surcoût annuel à la pompe par rapport à l'enseigne la moins chère, en centimes, et le coût carbone ETS2 à partir de 2028. Rien n'est enregistré.
/v1/fleet-costsScope fleet-costs:readcurl -X POST "https://api.floweet.com/v1/fleet-costs" \
-H "Authorization: Bearer $FLOWEET_API_KEY" \
-H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87" \
-H "Content-Type: application/json" \
-d '{
"fuel": "gazole",
"currentBrand": "Esso",
"reference": "cheapest",
"kmPerVehicle": 30000,
"lines": [
{
"type": "lcv",
"vehicles": 12,
"consumptionL100": 8.5
},
{
"type": "hgv",
"vehicles": 3,
"consumptionL100": 30
}
]
}'{
"fuel": "gazole",
"pricesFrom": "2026-10-19T11:35:43.000Z",
"pricesTo": "2026-10-26T11:00:00.000Z",
"vehicles": 15,
"currentBrand": "Esso",
"currentPrice": 2428,
"referenceBrand": "Total Access",
"referencePrice": 2252,
"lines": [
{
"type": "lcv",
"vehicles": 12,
"consumptionL100": 8.5,
"litersPerYear": 30600,
"overspendPerYear": 538600,
"overspendPerVehicle": 44900,
"co2Tonnes": 75.9,
"ets2PerYear": 341500
},
{
"type": "hgv",
"vehicles": 3,
"consumptionL100": 30,
"litersPerYear": 27000,
"overspendPerYear": 475200,
"overspendPerVehicle": 158400,
"co2Tonnes": 67,
"ets2PerYear": 301300
}
],
"total": {
"litersPerYear": 57600,
"overspendPerYear": 1013800,
"co2Tonnes": 142.8,
"ets2PerYear": 642800
},
"replaceFirst": "hgv",
"ets2": {
"startYear": 2028,
"pricePerTonne": 4500,
"costPerLiter": 112
}
}4. Enregistrez un prospect
La même flotte, enregistrée au nom d'un prospect de votre organisation : son coût est recalculé sur les prix de la semaine à chaque lecture. L'en-tête Idempotency-Key vous permet de réessayer sans créer deux fois le même prospect (voir idempotence).
/v1/prospectsScope prospects:writecurl -X POST "https://api.floweet.com/v1/prospects" \
-H "Authorization: Bearer $FLOWEET_API_KEY" \
-H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87" \
-H "Content-Type: application/json" \
-d '{
"name": "Transports Martin",
"fleet": {
"fuel": "gazole",
"currentBrand": "Esso",
"reference": "cheapest",
"kmPerVehicle": 30000,
"lines": [
{
"type": "lcv",
"vehicles": 12,
"consumptionL100": 8.5
},
{
"type": "hgv",
"vehicles": 3,
"consumptionL100": 30
}
]
}
}'{
"id": "33e3daba-2998-438d-a05e-1c513009107a",
"name": "Transports Martin",
"updatedAt": "2026-10-26T11:46:19.310433+00:00",
"input": {
"fuel": "gazole",
"currentBrand": "Esso",
"reference": "cheapest",
"kmPerVehicle": 30000,
"lines": [
{
"type": "lcv",
"vehicles": 12,
"consumptionL100": 8.5
},
{
"type": "hgv",
"vehicles": 3,
"consumptionL100": 30
}
]
},
"cost": {
"fuel": "gazole",
"pricesFrom": "2026-10-19T11:35:43.000Z",
"pricesTo": "2026-10-26T11:00:00.000Z",
"vehicles": 15,
"currentBrand": "Esso",
"currentPrice": 2428,
"referenceBrand": "Total Access",
"referencePrice": 2252,
"lines": [
{
"type": "lcv",
"vehicles": 12,
"consumptionL100": 8.5,
"litersPerYear": 30600,
"overspendPerYear": 538600,
"overspendPerVehicle": 44900,
"co2Tonnes": 75.9,
"ets2PerYear": 341500
},
{
"type": "hgv",
"vehicles": 3,
"consumptionL100": 30,
"litersPerYear": 27000,
"overspendPerYear": 475200,
"overspendPerVehicle": 158400,
"co2Tonnes": 67,
"ets2PerYear": 301300
}
],
"total": {
"litersPerYear": 57600,
"overspendPerYear": 1013800,
"co2Tonnes": 142.8,
"ets2PerYear": 642800
},
"replaceFirst": "hgv",
"ets2": {
"startYear": 2028,
"pricePerTonne": 4500,
"costPerLiter": 112
}
}
}La réponse 201 porte l'en-tête Location (/v1/prospects/{id}). Gardez l'id pour le relire ou le remplacer.
5. Trouvez une entreprise
L'annuaire SIRENE se cherche par nom, SIREN ou SIRET, avec un filtre par département ou par activité (code NAF). La fiche d'un établissement donne aussi une estimation de sa flotte (voir entreprises).
/v1/companiesScope companies:readcurl "https://api.floweet.com/v1/companies?q=transports%20martin" \
-H "Authorization: Bearer $FLOWEET_API_KEY"{
"results": [
{
"siret": "84983050000013",
"siren": "849830500",
"name": "TS TRANSPORTS",
"legalName": "TS TRANSPORTS",
"naf": "49.41A",
"address": "111 AVENUE ALEXANDER FLEMING",
"postalCode": "69300",
"city": "CALUIRE-ET-CUIRE",
"department": "69",
"location": {
"lat": 45.7936248779297,
"lng": 4.84831619262695
},
"headOffice": true,
"active": true
},
{
"siret": "85183625400017",
"siren": "851836254",
"name": "TRANSPORTS TR",
"legalName": "TRANSPORTS TR",
"naf": "49.32Z",
"address": "227 RUE DU GENERAL DE GAULLE",
"postalCode": "69530",
"city": "BRIGNAIS",
"department": "69",
"location": {
"lat": 45.6660766601562,
"lng": 4.75257873535156
},
"headOffice": true,
"active": true
}
]
}6. Passez en production
Quand votre intégration est prête, demandez l'ouverture en production à la même adresse. Après validation par notre équipe, vous recevez une clé fw_live_… : le même code, sans autre changement, agit alors en production, sans quota quotidien, et l'argumentaire d'une simulation est rédigé par l'IA quand le service est disponible (voir bac à sable et production).