Ir para o conteúdo
Floweet
Acesso profissional
API pública · Beta · Acesso mediante pedido

Os dados de combustível da Floweet, nas suas ferramentas.

Preços da semana e classificação das marcas, postos de abastecimento e pontos de carregamento, diretório SIRENE com a estimativa das frotas, sobrecusto de combustível e de carbono de uma frota, prospects e simulações: uma API REST em JSON, documentada em inglês e em francês, com um ambiente de testes.

Pedir acessoLer a documentação

A nossa equipa abre cada acesso: primeiro uma chave de testes, a produção após validação.

21 operações · 10 scopes · OpenAPI 3.1

Pedido
curl "https://api.floweet.com/v1/barometer?fuel=gazole" \
  -H "Authorization: Bearer $FLOWEET_API_KEY"
Resposta · 200 (excerto)
{
  "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 quem

Uma API para quem vende e gere a mobilidade

  • Cartões de combustível

    Emissores de cartões

    Calcule o sobrecusto de um prospect com os preços da semana, simule a cobertura da sua rede à volta dele e redija o argumentário, a partir do seu CRM.

  • Redes

    Redes de postos

    Acompanhe a sua posição na classificação das marcas, em França e em cada região, e compare os seus preços com os da concorrência local.

  • Frotas

    Gestores e software de frotas

    Mostre aos seus clientes os postos mais baratos do seu departamento, o sobrecusto da marca atual e o custo de carbono ETS2 a partir de 2028.

  • Ferramentas comerciais

    CRM e ferramentas de prospeção

    Enriqueça as suas fichas com o diretório SIRENE, a atividade, a rede da marca e a frota estimada de cada estabelecimento.

Recursos

Tudo o que a API disponibiliza hoje

Cada linha vem do contrato que a API aplica: as operações e os scopes abaixo são exatamente os que ela aceita.

Em preparação

  • Em breveEspaço de programadorCriar e revogar as suas chaves, acompanhar o consumo, pedir a produção por si mesmo.
  • Em breveWebhooks de saídaSer avisado de uma alteração de preço ou do avanço de uma simulação, sem consultar a API.
  • Em breveServidor MCPAs mesmas operações, abertas aos assistentes de IA, com os mesmos scopes.
  • Em breveAcesso incluído nas ofertasAbrir a API a partir da sua subscrição, sem pedido, com um pacote de chamadas.
Como funciona

Do pedido à produção, em três passos

  1. 1

    Pede acesso

    Indique a sua organização, o membro ADMIN em nome do qual a chave atuará e o que pretende construir.

  2. 2

    Integra no ambiente de testes

    Uma chave fw_test_ lê e escreve os mesmos dados que a produção, sem nunca chamar a IA, até 1.000 chamadas por dia.

  3. 3

    Passa para produção

    Após validação da nossa equipa, recebe uma chave fw_live_: o mesmo código, sem mais alterações.

Uma chave, os seus scopes

Uma chave pertence a uma organização e traz a lista do que pode fazer: um scope por rota, em leitura ou escrita (barometer:read, prospects:write…). Uma rota fora dos seus scopes responde 403 insufficient_scope.

A sua primeira chamada

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

Nada a aprender que ainda não conheça

  • Authorization: Bearer

    Uma chave, um cabeçalho

    Autenticação por token portador em HTTPS, nunca no URL nem num cookie.

  • Idempotency-KeyIdempotent-Replayed

    POST sem duplicados

    Repita um POST com a mesma chave de idempotência: a primeira resposta volta durante 24 horas, nada é criado duas vezes.

  • RateLimit-LimitRateLimit-RemainingRateLimit-ResetRetry-After

    Limites anunciados

    120 pedidos por minuto e por organização, anunciados em cada resposta; um 429 indica quando tentar de novo.

  • nextCursorhasMorelimit

    Paginação por cursor

    As listas respondem { data, nextCursor, hasMore }: estáveis mesmo quando chegam linhas entre duas páginas.

  • 201Location

    Recurso criado

    Uma criação responde 201 com o endereço do novo recurso.

  • Floweet-VersionFloweet-Environment

    Versão e ambiente

    Cada resposta indica a versão do contrato e o ambiente da chave (test ou live).

  • X-Request-Id

    Rastreabilidade

    Cada pedido tem um identificador, guardado nos nossos registos: cite-o se nos escrever.

  • Accept-Language

    Mensagens na sua língua

    As mensagens de erro seguem Accept-Language: francês, inglês, espanhol, italiano, alemão, português.

Uma única forma de erro

Todos os erros têm a mesma forma, com um código estável em que o seu código se pode apoiar.

A tabela de códigos de erro 
{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key does not have the scope required by this route.",
    "details": { "required": "prospects:write", "granted": ["barometer:read"] }
  }
}
Exemplo

Do sobrecusto de uma frota ao argumentário de venda

Três chamadas bastam para calcular uma frota, guardá-la como prospect e redigir o argumentário de uma simulação de cobertura.

  1. 1. Calcular a frota

    O sobrecusto anual na bomba por tipo de veículo, comparado com a marca mais barata, e o custo de carbono ETS2. Nada é guardado.

    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. Guardá-la como prospect

    A mesma frota, guardada e recalculada todas as semanas. A chave de idempotência evita duplicados se tentar de novo.

    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. Redigir o argumentário

    Para uma simulação de cobertura da sua rede: redigido pela IA com uma chave live, a partir do modelo no ambiente de testes.

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

Segura por conceção

  • Chaves nunca guardadas

    Só a impressão SHA-256 da sua chave é guardada. Uma revogação aplica-se em menos de um minuto.

  • De servidor para servidor

    Nenhum pedido de navegador é aceite em /v1: a sua chave fica no seu servidor.

  • Os direitos de um membro

    A chave atua em nome de um membro ADMIN designado da sua organização: vê o que ele vê, com a sua oferta, nunca mais.

  • Scopes em lista fechada

    Dez scopes possíveis, verificados pela API e pela base de dados.

  • Ambiente de testes sem IA

    Uma chave fw_test_ nunca chama a IA, até 1.000 chamadas por dia.

  • Um contrato gerado

    A documentação vem dos esquemas que validam os seus pedidos: não os pode contradizer.

  • Nunca uma rutura

    /v1 nunca remove nem muda o nome de nada. Uma rutura será uma /v2, com 12 meses de coexistência.

  • Um registo mínimo

    Cada chamada é registada sem endereço IP nem conteúdo, e guardada 12 meses.

  • Alojada em França

    Base de dados e API funcionam nos nossos servidores em França.

A nossa política de privacidade Condições de utilização
Documentação

Tudo está escrito, em inglês e em francês

A documentação completaInício rápido, autenticação, ambiente de testes, scopes, cada recurso e cada operação, paginação, idempotência, limites, erros e versões, com exemplos em curl, JavaScript e Python.Abrir a documentação

Perguntas frequentes

Como obter uma chave de API?

Escreva para contact@floweet.com indicando a sua organização, o membro ADMIN em nome do qual a chave atuará e o seu projeto. A nossa equipa entrega-lhe uma chave de testes fw_test_ e, após validação, uma chave de produção fw_live_.

Quanto custa a API?

A API está em beta: o acesso é aberto mediante pedido, sem faturação por chamada. Os limites são fixos: 120 pedidos por minuto e por organização, 1.000 chamadas por dia no ambiente de testes.

De onde vêm os dados?

Preços: prix-carburants.gouv.fr. Carregamento: ficheiro consolidado IRVE. Empresas: diretório SIRENE do Insee. Moradas: Base Adresse Nationale e depois OpenStreetMap. Qualquer reutilização deve citar estas fontes.

O que faz uma chave de testes?

Uma chave fw_test_ lê e escreve os mesmos dados que a produção, mas nunca chama a IA: o argumentário é redigido a partir do modelo. Está limitada a 1.000 chamadas por dia.

Posso chamar a API a partir de um navegador?

Não. A chave é um segredo: a API não aceita pedidos de navegador em /v1. Chame-a a partir do seu servidor.

A API pode mudar?

/v1 nunca remove nem muda o nome de um campo ou de uma rota: só são possíveis acréscimos. Uma rutura será uma /v2, disponibilizada durante 12 meses ao lado de /v1.

Ligue a Floweet às suas ferramentas

Uma chave de testes espera por si: escreva-nos e abrimos o acesso.

Pedir acessoLer a documentação
  • Ambiente de testes com os mesmos dados
  • Documentação em inglês e em francês
  • Nenhuma rutura em /v1