API pública · Beta · Acceso bajo solicitud

Los datos de carburante de Floweet, en sus herramientas.

Precios de la semana y clasificación de marcas, estaciones de servicio y puntos de recarga, directorio SIRENE con la estimación de las flotas, sobrecoste de carburante y de carbono de una flota, prospectos y simulaciones: una API REST en JSON, documentada en inglés y en francés, con un entorno de pruebas.

Solicitar acceso Leer la documentación

Nuestro equipo abre cada acceso: primero una clave de pruebas, la producción tras validación.

21 operaciones · 10 scopes · OpenAPI 3.1

Solicitud

curl "https://api.floweet.com/v1/barometer?fuel=gazole" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"

Respuesta · 200 (extracto)

{
  "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
    }
  }
}

Para quién

Una API para quienes venden y gestionan la movilidad

Tarjetas de carburante
Emisores de tarjetas
Calcule el sobrecoste de un prospecto con los precios de la semana, simule la cobertura de su red a su alrededor y redacte el argumentario, desde su CRM.
Redes
Redes de estaciones
Siga su posición en la clasificación de marcas, en Francia y en cada región, y compare sus precios con los de la competencia local.
Flotas
Gestores y software de flotas
Muestre a sus clientes las estaciones más baratas de su departamento, el sobrecoste de su marca actual y su coste de carbono ETS2 a partir de 2028.
Herramientas comerciales
CRM y herramientas de prospección
Enriquezca sus fichas con el directorio SIRENE, la actividad, la red de la marca y la flota estimada de cada establecimiento.

Recursos

Todo lo que la API sirve hoy

Cada fila procede del contrato que aplica la API: las operaciones y los scopes de abajo son exactamente los que acepta.

RecursoQué permiteOperaciones

Barómetro
barometer:read
La clasificación de marcas por precio medio, en Francia y en sus 13 regiones, para cinco carburantes, con o sin autopistas.
- GET/v1/barometer
Estaciones de servicio
fuel-stations:read
Las estaciones de Francia y de Europa: precio por carburante, servicios, horarios y las diez más baratas de un departamento.
Puntos de recarga
charging-stations:read
Los puntos de recarga públicos del fichero IRVE: red, potencia, conectores, gratuidad, pago con tarjeta.
- GET/v1/charging-stations
- GET/v1/charging-stations/{id}
Empresas
companies:read
El directorio SIRENE: búsqueda por nombre, SIREN o SIRET, unidad legal, actividad y flota estimada.
- GET/v1/companies
- GET/v1/companies/{siret}
Coste de una flota
fleet-costs:read
El sobrecoste anual en el surtidor de una flota por tipo de vehículo y su coste de carbono ETS2. No se guarda nada.
- POST/v1/fleet-costs
Prospectos
prospects:readprospects:write
Las flotas de sus prospectos, con su sobrecoste recalculado con los precios de la semana.
Simulaciones
simulations:readsimulations:write
La cobertura de su red alrededor de un cliente, su estado comercial y su argumentario de venta.
Geocodificación e itinerarios
geo:read
Las coordenadas de una dirección y un itinerario por carretera de 2 a 25 puntos.
- GET/v1/geocode
- POST/v1/routes

En preparación

PróximamenteEspacio para desarrolladoresCrear y revocar sus claves, seguir su consumo, solicitar la producción usted mismo.
PróximamenteWebhooks salientesRecibir aviso de un cambio de precio o del avance de una simulación, sin consultar la API.
PróximamenteServidor MCPLas mismas operaciones, abiertas a los asistentes de IA, con los mismos scopes.
PróximamenteAcceso incluido en las ofertasAbrir la API desde su suscripción, sin solicitud, con un paquete de llamadas.

Cómo funciona

De la solicitud a la producción, en tres pasos

1
Solicita acceso
Indique su organización, el miembro ADMIN en cuyo nombre actuará la clave y lo que desea construir.
2
Integra en el entorno de pruebas
Una clave fw_test_ lee y escribe los mismos datos que la producción, sin llamar nunca a la IA, con un límite de 1000 llamadas al día.
3
Pasa a producción
Tras la validación de nuestro equipo, recibe una clave fw_live_: el mismo código, sin ningún otro cambio.

Una clave, sus scopes

Una clave pertenece a una organización y lleva la lista de lo que puede hacer: un scope por ruta, de lectura o de escritura (barometer:read, prospects:write…). Una ruta fuera de sus scopes responde 403 insufficient_scope.

Su primera llamada

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

Diseñada según los estándares

Nada que aprender que no conozca ya

Authorization: Bearer
Una clave, una cabecera
Autenticación por token portador en HTTPS, nunca en la URL ni en una cookie.
Idempotency-KeyIdempotent-Replayed
POST sin duplicados
Repita un POST con la misma clave de idempotencia: la primera respuesta vuelve durante 24 horas, nada se crea dos veces.
RateLimit-LimitRateLimit-RemainingRateLimit-ResetRetry-After
Límites anunciados
120 solicitudes por minuto y por organización, anunciadas en cada respuesta; un 429 indica cuándo reintentar.
nextCursorhasMorelimit
Paginación por cursor
Las listas responden { data, nextCursor, hasMore }: estables aunque lleguen filas entre dos páginas.
201Location
Recurso creado
Una creación responde 201 con la dirección del nuevo recurso.
Floweet-VersionFloweet-Environment
Versión y entorno
Cada respuesta indica la versión del contrato y el entorno de la clave (test o live).
X-Request-Id
Trazabilidad
Cada solicitud lleva un identificador, guardado en nuestros registros: cítelo si nos escribe.
Accept-Language
Mensajes en su idioma
Los mensajes de error siguen Accept-Language: francés, inglés, español, italiano, alemán, portugués.

Una sola forma de error

Todos los errores tienen la misma forma, con un código estable en el que su código puede apoyarse.

La tabla de códigos de error

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

Ejemplo

Del sobrecoste de una flota al argumentario de venta

Tres llamadas bastan para calcular una flota, guardarla como prospecto y redactar el argumentario de una simulación de cobertura.

1. Calcular la flota

El sobrecoste anual en el surtidor por tipo de vehículo, comparado con la marca más barata, y el coste de carbono ETS2. No se guarda nada.

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. Guardarla como prospecto

La misma flota, guardada y recalculada cada semana. La clave de idempotencia evita duplicados si reintenta.

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. Redactar el argumentario

Para una simulación de cobertura de su red: redactado por la IA con una clave live, con la plantilla en el entorno de pruebas.

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"

Garantías

Segura por diseño

Claves nunca almacenadas
Solo se guarda la huella SHA-256 de su clave. Una revocación se aplica en menos de un minuto.
De servidor a servidor
No se acepta ninguna solicitud de navegador en /v1: su clave se queda en su servidor.
Los derechos de un miembro
La clave actúa en nombre de un miembro ADMIN designado de su organización: ve lo que él ve, con su oferta, nunca más.
Scopes en lista cerrada
Diez scopes posibles, verificados por la API y por la base de datos.
Entorno de pruebas sin IA
Una clave fw_test_ nunca llama a la IA, con un límite de 1000 llamadas al día.
Un contrato generado
La documentación procede de los esquemas que validan sus solicitudes: no puede contradecirlos.
Nunca una ruptura
/v1 nunca elimina ni renombra nada. Una ruptura será una /v2, con 12 meses de coexistencia.
Un registro mínimo
Cada llamada se registra sin dirección IP ni contenido, y se conserva 12 meses.
Alojada en Francia
La base de datos y la API funcionan en nuestros servidores en Francia.

Nuestra política de privacidad Condiciones de uso

Documentación

Todo está escrito, en inglés y en francés

La documentación completaInicio rápido, autenticación, entorno de pruebas, scopes, cada recurso y cada operación, paginación, idempotencia, límites, errores y versiones, con ejemplos en curl, JavaScript y Python.Abrir la documentación

Preguntas frecuentes

¿Cómo obtener una clave de API?

Escriba a contact@floweet.com indicando su organización, el miembro ADMIN en cuyo nombre actuará la clave y su proyecto. Nuestro equipo le entrega una clave de pruebas fw_test_ y, tras validación, una clave de producción fw_live_.

¿Cuánto cuesta la API?

La API está en beta: el acceso se abre bajo solicitud, sin facturación por llamada. Los límites son fijos: 120 solicitudes por minuto y por organización, 1000 llamadas al día en el entorno de pruebas.

¿De dónde proceden los datos?

Precios: prix-carburants.gouv.fr. Recarga: fichero consolidado IRVE. Empresas: directorio SIRENE del Insee. Direcciones: Base Adresse Nationale y luego OpenStreetMap. Toda reutilización debe citar estas fuentes.

¿Qué hace una clave de pruebas?

Una clave fw_test_ lee y escribe los mismos datos que la producción, pero nunca llama a la IA: el argumentario se redacta con la plantilla. Está limitada a 1000 llamadas al día.

¿Puedo llamar a la API desde un navegador?

No. La clave es un secreto: la API no acepta solicitudes de navegador en /v1. Llámela desde su servidor.

¿Puede cambiar la API?

/v1 nunca elimina ni renombra un campo ni una ruta: solo son posibles las adiciones. Una ruptura será una /v2, servida 12 meses junto a /v1.

Conecte Floweet a sus herramientas

Le espera una clave de pruebas: escríbanos y abrimos el acceso.

Solicitar acceso Leer la documentación

Entorno de pruebas con los mismos datos
Documentación en inglés y en francés
Ninguna ruptura en /v1

Los datos de carburante de Floweet, en sus herramientas.

Una API para quienes venden y gestionan la movilidad

Emisores de tarjetas

Redes de estaciones

Gestores y software de flotas

CRM y herramientas de prospección

Todo lo que la API sirve hoy

En preparación

De la solicitud a la producción, en tres pasos

Solicita acceso

Integra en el entorno de pruebas

Pasa a producción

Una clave, sus scopes

Su primera llamada

Nada que aprender que no conozca ya

Una clave, una cabecera

POST sin duplicados

Límites anunciados

Paginación por cursor

Recurso creado

Versión y entorno

Trazabilidad

Mensajes en su idioma

Una sola forma de error

Del sobrecoste de una flota al argumentario de venta

1. Calcular la flota

2. Guardarla como prospecto

3. Redactar el argumentario

Segura por diseño

Claves nunca almacenadas

De servidor a servidor

Los derechos de un miembro

Scopes en lista cerrada

Entorno de pruebas sin IA

Un contrato generado

Nunca una ruptura

Un registro mínimo

Alojada en Francia

Todo está escrito, en inglés y en francés

Preguntas frecuentes

Conecte Floweet a sus herramientas