Zum Inhalt springen
Floweet
Profi-Zugang
Öffentliche API · Beta · Zugang auf Anfrage

Die Kraftstoffdaten von Floweet, in Ihren Tools.

Preise der Woche und Markenranking, Tankstellen und Ladesäulen, das SIRENE-Verzeichnis mit geschätzten Flotten, Kraftstoff- und CO2-Mehrkosten einer Flotte, Interessenten und Simulationen: eine JSON-REST-API, dokumentiert auf Englisch und Französisch, mit einer Testumgebung.

Zugang anfragenDokumentation lesen

Unser Team schaltet jeden Zugang frei: zuerst einen Testschlüssel, die Produktion nach Freigabe.

21 Operationen · 10 Scopes · OpenAPI 3.1

Anfrage
curl "https://api.floweet.com/v1/barometer?fuel=gazole" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Antwort · 200 (Auszug)
{
  "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
    }
  }
}
Für wen

Eine API für alle, die Mobilität verkaufen und verwalten

  • Tankkarten

    Tankkartenanbieter

    Berechnen Sie die Mehrkosten eines Interessenten mit den Preisen der Woche, simulieren Sie die Abdeckung Ihres Netzes um ihn herum und verfassen Sie das Verkaufsargument, direkt aus Ihrem CRM.

  • Netze

    Tankstellennetze

    Verfolgen Sie Ihre Position im Markenranking, in Frankreich und in jeder Region, und vergleichen Sie Ihre Preise mit dem lokalen Wettbewerb.

  • Flotten

    Fuhrparkverantwortliche und Flottensoftware

    Zeigen Sie Ihren Kunden die günstigsten Tankstellen ihres Départements, die Mehrkosten ihrer aktuellen Marke und ihre ETS2-CO2-Kosten ab 2028.

  • Vertriebstools

    CRM und Akquise-Tools

    Ergänzen Sie Ihre Datensätze um das SIRENE-Verzeichnis, die Tätigkeit, das Markennetz und die geschätzte Flotte jedes Betriebs.

Ressourcen

Alles, was die API heute liefert

Jede Zeile stammt aus dem Vertrag, den die API durchsetzt: Die Operationen und Scopes unten sind genau die, die sie akzeptiert.

In Vorbereitung

  • DemnächstEntwicklerbereichSchlüssel selbst erstellen und widerrufen, Nutzung verfolgen, die Produktion selbst anfragen.
  • DemnächstAusgehende WebhooksBei einer Preisänderung oder dem Fortschritt einer Simulation benachrichtigt werden, ohne die API abzufragen.
  • DemnächstMCP-ServerDieselben Operationen, für KI-Assistenten geöffnet, mit denselben Scopes.
  • DemnächstZugang in den Angeboten enthaltenDie API aus Ihrem Abonnement freischalten, ohne Anfrage, mit einem Aufrufkontingent.
So funktioniert es

Von der Anfrage zur Produktion, in drei Schritten

  1. 1

    Sie fragen den Zugang an

    Nennen Sie Ihre Organisation, das ADMIN-Mitglied, in dessen Namen der Schlüssel handelt, und was Sie bauen möchten.

  2. 2

    Sie integrieren in der Testumgebung

    Ein fw_test_-Schlüssel liest und schreibt dieselben Daten wie die Produktion, ruft nie die KI auf, bis zu 1.000 Aufrufe pro Tag.

  3. 3

    Sie gehen in Produktion

    Nach Freigabe durch unser Team erhalten Sie einen fw_live_-Schlüssel: derselbe Code, sonst nichts zu ändern.

Ein Schlüssel, seine Scopes

Ein Schlüssel gehört zu einer Organisation und trägt die Liste dessen, was er darf: ein Scope pro Route, lesend oder schreibend (barometer:read, prospects:write…). Eine Route außerhalb seiner Scopes antwortet 403 insufficient_scope.

Ihr erster Aufruf

curl "https://api.floweet.com/v1/fuel-stations/cheapest?department=78" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Nach Standards gebaut

Nichts zu lernen, was Sie nicht schon kennen

  • Authorization: Bearer

    Ein Schlüssel, ein Header

    Authentifizierung per Bearer-Token über HTTPS, nie in der URL oder in einem Cookie.

  • Idempotency-KeyIdempotent-Replayed

    POST ohne Duplikate

    Wiederholen Sie einen POST mit demselben Idempotenzschlüssel: Die erste Antwort kommt 24 Stunden lang zurück, nichts wird doppelt angelegt.

  • RateLimit-LimitRateLimit-RemainingRateLimit-ResetRetry-After

    Angekündigte Limits

    120 Anfragen pro Minute und Organisation, in jeder Antwort angekündigt; ein 429 sagt, wann Sie es erneut versuchen können.

  • nextCursorhasMorelimit

    Cursor-Paginierung

    Listen antworten { data, nextCursor, hasMore }: stabil, auch wenn zwischen zwei Seiten Zeilen hinzukommen.

  • 201Location

    Angelegte Ressource

    Eine Anlage antwortet 201 mit der Adresse der neuen Ressource.

  • Floweet-VersionFloweet-Environment

    Version und Umgebung

    Jede Antwort nennt die Vertragsversion und die Umgebung des Schlüssels (test oder live).

  • X-Request-Id

    Nachvollziehbarkeit

    Jede Anfrage trägt eine Kennung, die in unseren Logs gespeichert wird: Nennen Sie sie, wenn Sie uns schreiben.

  • Accept-Language

    Meldungen in Ihrer Sprache

    Fehlermeldungen folgen Accept-Language: Französisch, Englisch, Spanisch, Italienisch, Deutsch, Portugiesisch.

Eine einzige Fehlerform

Alle Fehler haben dieselbe Form, mit einem stabilen Code, auf den sich Ihr Code verlassen kann.

Die Tabelle der Fehlercodes 
{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key does not have the scope required by this route.",
    "details": { "required": "prospects:write", "granted": ["barometer:read"] }
  }
}
Beispiel

Von den Mehrkosten einer Flotte zum Verkaufsargument

Drei Aufrufe genügen, um eine Flotte zu berechnen, sie als Interessenten zu speichern und das Argument einer Abdeckungssimulation zu verfassen.

  1. 1. Die Flotte berechnen

    Die jährlichen Mehrkosten an der Zapfsäule je Fahrzeugtyp, verglichen mit der günstigsten Marke, und die ETS2-CO2-Kosten. Es wird nichts gespeichert.

    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. Als Interessenten speichern

    Dieselbe Flotte, gespeichert und jede Woche neu berechnet. Der Idempotenzschlüssel verhindert Duplikate, wenn Sie es erneut versuchen.

    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. Das Argument verfassen

    Für eine Simulation der Abdeckung Ihres Netzes: von der KI verfasst mit einem live-Schlüssel, aus der Vorlage in der Testumgebung.

    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"
Garantien

Sicher durch Bauweise

  • Schlüssel nie gespeichert

    Nur der SHA-256-Fingerabdruck Ihres Schlüssels wird aufbewahrt. Ein Widerruf greift in weniger als einer Minute.

  • Server zu Server

    Auf /v1 wird keine Browser-Anfrage akzeptiert: Ihr Schlüssel bleibt auf Ihrem Server.

  • Die Rechte eines Mitglieds

    Der Schlüssel handelt im Namen eines benannten ADMIN-Mitglieds Ihrer Organisation: Er sieht, was es sieht, mit Ihrem Angebot, nie mehr.

  • Geschlossene Scope-Liste

    Zehn mögliche Scopes, geprüft von der API und von der Datenbank.

  • Testumgebung ohne KI

    Ein fw_test_-Schlüssel ruft nie die KI auf, bis zu 1.000 Aufrufe pro Tag.

  • Ein generierter Vertrag

    Die Dokumentation stammt aus den Schemas, die Ihre Anfragen prüfen: Sie kann ihnen nicht widersprechen.

  • Nie ein Bruch

    /v1 entfernt oder benennt nie etwas um. Ein Bruch wird eine /v2, mit 12 Monaten Parallelbetrieb.

  • Ein minimales Protokoll

    Jeder Aufruf wird ohne IP-Adresse und ohne Inhalt protokolliert und 12 Monate aufbewahrt.

  • In Frankreich gehostet

    Datenbank und API laufen auf unseren Servern in Frankreich.

Unsere Datenschutzerklärung Nutzungsbedingungen
Dokumentation

Alles ist beschrieben, auf Englisch und Französisch

Die vollständige DokumentationSchnellstart, Authentifizierung, Testumgebung, Scopes, jede Ressource und jede Operation, Paginierung, Idempotenz, Limits, Fehler und Versionen, mit Beispielen in curl, JavaScript und Python.Dokumentation öffnen

Häufige Fragen

Wie erhalte ich einen API-Schlüssel?

Schreiben Sie an contact@floweet.com mit Ihrer Organisation, dem ADMIN-Mitglied, in dessen Namen der Schlüssel handelt, und Ihrem Projekt. Unser Team gibt Ihnen einen fw_test_-Testschlüssel und nach Freigabe einen fw_live_-Produktionsschlüssel.

Was kostet die API?

Die API ist in der Beta: Der Zugang wird auf Anfrage freigeschaltet, ohne Abrechnung pro Aufruf. Die Limits sind fest: 120 Anfragen pro Minute und Organisation, 1.000 Aufrufe pro Tag in der Testumgebung.

Woher stammen die Daten?

Preise: prix-carburants.gouv.fr. Laden: die konsolidierte IRVE-Datei. Unternehmen: das SIRENE-Verzeichnis des Insee. Adressen: die Base Adresse Nationale, dann OpenStreetMap. Jede Weiterverwendung muss diese Quellen nennen.

Was macht ein Testschlüssel?

Ein fw_test_-Schlüssel liest und schreibt dieselben Daten wie die Produktion, ruft aber nie die KI auf: Das Argument wird aus der Vorlage verfasst. Er ist auf 1.000 Aufrufe pro Tag begrenzt.

Kann ich die API aus einem Browser aufrufen?

Nein. Der Schlüssel ist ein Geheimnis: Die API akzeptiert auf /v1 keine Browser-Anfragen. Rufen Sie sie von Ihrem Server aus auf.

Kann sich die API ändern?

/v1 entfernt oder benennt nie ein Feld oder eine Route um: Nur Ergänzungen sind möglich. Ein Bruch wird eine /v2, die 12 Monate parallel zu /v1 bereitsteht.

Verbinden Sie Floweet mit Ihren Tools

Ein Testschlüssel wartet auf Sie: Schreiben Sie uns, wir schalten den Zugang frei.

Zugang anfragenDokumentation lesen
  • Testumgebung mit denselben Daten
  • Dokumentation auf Englisch und Französisch
  • Kein Bruch auf /v1