Vai al contenuto
Floweet
Accesso professionisti
API pubblica · Beta · Accesso su richiesta

I dati sui carburanti di Floweet, nei suoi strumenti.

Prezzi della settimana e classifica delle insegne, stazioni di servizio e colonnine di ricarica, anagrafe SIRENE con la stima delle flotte, sovraccosto di carburante e di carbonio di una flotta, prospect e simulazioni: un'API REST in JSON, documentata in inglese e in francese, con un ambiente di prova.

Richiedere l'accessoLeggere la documentazione

Il nostro team apre ogni accesso: prima una chiave di prova, la produzione dopo la convalida.

21 operazioni · 10 scope · OpenAPI 3.1

Richiesta
curl "https://api.floweet.com/v1/barometer?fuel=gazole" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Risposta · 200 (estratto)
{
  "fuel": "gazole",
  "pricesFrom": "2026-10-19T11:35:43.000Z",
  "pricesTo": "2026-10-26T11:00:00.000Z",
  "national": {
    "excludingHighways": {
      "brands": [
        {
          "brand": "Total Access",
          "averagePrice": 2252,
          "stations": 219,
          "others": false
        },
        {
          "brand": "TotalEnergies",
          "averagePrice": 2252,
          "stations": 743,
          "others": false
        }
      ],
      "stations": 6024
    }
  }
}
Per chi

Un'API per chi vende e gestisce la mobilità

  • Carte carburante

    Emittenti di carte

    Calcoli il sovraccosto di un prospect sui prezzi della settimana, simuli la copertura della sua rete intorno a lui e scriva l'argomentario, dal suo CRM.

  • Reti

    Reti di stazioni

    Segua la sua posizione nella classifica delle insegne, in Francia e in ogni regione, e confronti i suoi prezzi con quelli della concorrenza locale.

  • Flotte

    Gestori e software di flotta

    Mostri ai suoi clienti le stazioni più economiche del loro dipartimento, il sovraccosto dell'insegna attuale e il costo del carbonio ETS2 dal 2028.

  • Strumenti commerciali

    CRM e strumenti di prospezione

    Arricchisca le sue schede con l'anagrafe SIRENE, l'attività, la rete dell'insegna e la flotta stimata di ogni stabilimento.

Risorse

Tutto ciò che l'API offre oggi

Ogni riga proviene dal contratto applicato dall'API: le operazioni e gli scope qui sotto sono esattamente quelli che accetta.

In preparazione

  • PrestoSpazio sviluppatoriCreare e revocare le sue chiavi, seguire i consumi, richiedere la produzione in autonomia.
  • PrestoWebhook in uscitaEssere avvisato di una variazione di prezzo o dell'avanzamento di una simulazione, senza interrogare l'API.
  • PrestoServer MCPLe stesse operazioni, aperte agli assistenti IA, con gli stessi scope.
  • PrestoAccesso incluso nelle offerteAprire l'API dal suo abbonamento, senza richiesta, con un pacchetto di chiamate.
Come funziona

Dalla richiesta alla produzione, in tre passi

  1. 1

    Richiede l'accesso

    Indichi la sua organizzazione, il membro ADMIN a nome del quale agirà la chiave e cosa desidera costruire.

  2. 2

    Integra nell'ambiente di prova

    Una chiave fw_test_ legge e scrive gli stessi dati della produzione, senza mai chiamare l'IA, entro 1000 chiamate al giorno.

  3. 3

    Passa in produzione

    Dopo la convalida del nostro team riceve una chiave fw_live_: lo stesso codice, senza altre modifiche.

Una chiave, i suoi scope

Una chiave appartiene a un'organizzazione e porta l'elenco di ciò che può fare: uno scope per rotta, in lettura o in scrittura (barometer:read, prospects:write…). Una rotta fuori dai suoi scope risponde 403 insufficient_scope.

La sua prima chiamata

curl "https://api.floweet.com/v1/fuel-stations/cheapest?department=78" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Progettata secondo gli standard

Niente da imparare che non conosca già

  • Authorization: Bearer

    Una chiave, un'intestazione

    Autenticazione con token bearer in HTTPS, mai nell'URL né in un cookie.

  • Idempotency-KeyIdempotent-Replayed

    POST senza duplicati

    Ripeta un POST con la stessa chiave di idempotenza: la prima risposta torna per 24 ore, nulla viene creato due volte.

  • RateLimit-LimitRateLimit-RemainingRateLimit-ResetRetry-After

    Limiti annunciati

    120 richieste al minuto per organizzazione, annunciate in ogni risposta; un 429 indica quando riprovare.

  • nextCursorhasMorelimit

    Paginazione a cursore

    Gli elenchi rispondono { data, nextCursor, hasMore }: stabili anche quando arrivano righe tra due pagine.

  • 201Location

    Risorsa creata

    Una creazione risponde 201 con l'indirizzo della nuova risorsa.

  • Floweet-VersionFloweet-Environment

    Versione e ambiente

    Ogni risposta indica la versione del contratto e l'ambiente della chiave (test o live).

  • X-Request-Id

    Tracciabilità

    Ogni richiesta porta un identificativo, conservato nei nostri log: lo citi se ci scrive.

  • Accept-Language

    Messaggi nella sua lingua

    I messaggi di errore seguono Accept-Language: francese, inglese, spagnolo, italiano, tedesco, portoghese.

Una sola forma di errore

Tutti gli errori hanno la stessa forma, con un codice stabile su cui il suo codice può contare.

La tabella dei codici di errore 
{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key does not have the scope required by this route.",
    "details": { "required": "prospects:write", "granted": ["barometer:read"] }
  }
}
Esempio

Dal sovraccosto di una flotta all'argomentario di vendita

Tre chiamate bastano per calcolare una flotta, salvarla come prospect e scrivere l'argomentario di una simulazione di copertura.

  1. 1. Calcolare la flotta

    Il sovraccosto annuo alla pompa per tipo di veicolo, confrontato con l'insegna più economica, e il costo del carbonio ETS2. Non viene salvato nulla.

    curl -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
    }
  ]
}'

  2. 2. Salvarla come prospect

    La stessa flotta, conservata e ricalcolata ogni settimana. La chiave di idempotenza evita duplicati se riprova.

    curl -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
      }
    ]
  }
}'

  3. 3. Scrivere l'argomentario

    Per una simulazione di copertura della sua rete: scritto dall'IA con una chiave live, dal modello nell'ambiente di prova.

    curl -X POST "https://api.floweet.com/v1/simulations/7d0c1f8e-2a4b-4c6d-9e8f-0a1b2c3d4e5f/pitch" \
  -H "Authorization: Bearer $FLOWEET_API_KEY" \
  -H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87"
Garanzie

Sicura per costruzione

  • Chiavi mai memorizzate

    Viene conservata solo l'impronta SHA-256 della sua chiave. Una revoca si applica in meno di un minuto.

  • Da server a server

    Nessuna richiesta da browser è accettata su /v1: la sua chiave resta sul suo server.

  • I diritti di un membro

    La chiave agisce a nome di un membro ADMIN designato della sua organizzazione: vede ciò che vede lui, con la sua offerta, mai di più.

  • Scope in elenco chiuso

    Dieci scope possibili, verificati dall'API e dal database.

  • Ambiente di prova senza IA

    Una chiave fw_test_ non chiama mai l'IA, entro 1000 chiamate al giorno.

  • Un contratto generato

    La documentazione deriva dagli schemi che convalidano le sue richieste: non può contraddirli.

  • Mai una rottura

    /v1 non rimuove né rinomina mai nulla. Una rottura sarà una /v2, con 12 mesi di coesistenza.

  • Un registro minimo

    Ogni chiamata è registrata senza indirizzo IP né contenuto, e conservata 12 mesi.

  • Ospitata in Francia

    Database e API funzionano sui nostri server in Francia.

La nostra informativa sulla privacy Condizioni d'uso
Documentazione

Tutto è scritto, in inglese e in francese

La documentazione completaAvvio rapido, autenticazione, ambiente di prova, scope, ogni risorsa e ogni operazione, paginazione, idempotenza, limiti, errori e versioni, con esempi in curl, JavaScript e Python.Aprire la documentazione

Domande frequenti

Come ottenere una chiave API?

Scriva a contact@floweet.com indicando la sua organizzazione, il membro ADMIN a nome del quale agirà la chiave e il suo progetto. Il nostro team le consegna una chiave di prova fw_test_ e, dopo la convalida, una chiave di produzione fw_live_.

Quanto costa l'API?

L'API è in beta: l'accesso è aperto su richiesta, senza fatturazione a chiamata. I limiti sono fissi: 120 richieste al minuto per organizzazione, 1000 chiamate al giorno nell'ambiente di prova.

Da dove provengono i dati?

Prezzi: prix-carburants.gouv.fr. Ricarica: file consolidato IRVE. Aziende: anagrafe SIRENE dell'Insee. Indirizzi: Base Adresse Nationale, poi OpenStreetMap. Ogni riutilizzo deve citare queste fonti.

Cosa fa una chiave di prova?

Una chiave fw_test_ legge e scrive gli stessi dati della produzione, ma non chiama mai l'IA: l'argomentario è scritto dal modello. È limitata a 1000 chiamate al giorno.

Posso chiamare l'API da un browser?

No. La chiave è un segreto: l'API non accetta richieste da browser su /v1. La chiami dal suo server.

L'API può cambiare?

/v1 non rimuove né rinomina mai un campo o una rotta: sono possibili solo aggiunte. Una rottura sarà una /v2, servita per 12 mesi accanto a /v1.

Colleghi Floweet ai suoi strumenti

Una chiave di prova la aspetta: ci scriva, apriamo l'accesso.

Richiedere l'accessoLeggere la documentazione
  • Ambiente di prova sugli stessi dati
  • Documentazione in inglese e in francese
  • Nessuna rottura su /v1