FlowData

Como criar uma chave de API do FlowData?

Publicado em 10. novembro 2026

Para que seu software possa chamar o FlowData, ele precisa de uma chave FlowData. Ela começa com fd_, vale para todas as áreas do FlowData e é enviada no cabeçalho Authorization em cada requisição. Você mesmo cria a chave em poucos segundos.

Criar uma chave

  1. Na barra lateral, abra Chaves de API.
  2. Clique em Nova chave, no canto superior direito.
  3. Em Nome, escreva algo que ajude a lembrar para que serve a chave, por exemplo "Loja virtual".
  4. Em Validade, escolha se a chave expira depois de 30, 90 ou 365 dias ou se Não expira.
  5. Opcional: informe um Limite mensal em euros inteiros (de 1 a 100.000). Mais detalhes abaixo.
  6. Clique em Criar.

A caixa de diálogo Criar chave FlowData com nome, validade e limite mensal

Logo em seguida aparece Sua nova chave. Copie o valor imediatamente e guarde-o em um lugar seguro, como a configuração do seu servidor. Ele é exibido apenas desta vez. Clique em Concluir para fechar a caixa de diálogo.

A caixa de diálogo com a nova chave, exibida apenas uma vez

Usar a chave

Envie a chave como token Bearer. Um teste simples com IP Geolocation:

curl "https://api.flowdata.one/v1/geolocation/8.8.8.8?lang=de" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

A chave funciona apenas nos endpoints do FlowData. Para os módulos do FlowSuite, como FlowCRM ou Flow Accounting, continue usando as chaves do seu perfil. Você também encontra todas as chaves dos seus produtos em um só lugar no FlowConnect, veja Chaves de API e MCP.

Nunca use a chave no código do navegador do seu site, senão qualquer visitante pode lê-la. Chame o FlowData sempre a partir do seu servidor e nunca coloque a chave na URL.

A lista de chaves

Para cada chave, a lista mostra o Status com a data de expiração, as Requisições do mês atual com o limite, quando e por quem ela foi Criada e o Último uso. Proprietários e pessoas com gestão da equipe veem todas as chaves FlowData da equipe; os demais veem apenas as próprias.

A lista de chaves FlowData com status, requisições, limite e último uso

As ações ficam à direita de cada linha:

  • Editar: altera o nome, a data de expiração (Expira em) e o Limite mensal. Se você deixar a data em branco, a chave não expira.
  • Gerar novamente: cria um novo valor para a mesma chave. O valor anterior continua funcionando por um curto período de transição, e a duração aparece na caixa de confirmação. Durante esse tempo, a lista mostra o status Em troca, assim você migra sua integração sem que requisições falhem. Essa ação só está disponível para quem criou a chave.
  • Revogar: a chave para de funcionar imediatamente. Isso não pode ser desfeito. Chaves revogadas permanecem na lista com o status Revogada para fins de histórico.

O limite mensal

O limite define quanto uma única chave pode gastar por mês civil, tanto nas áreas de dados quanto no processamento de mídia. Os trabalhos de mídia em andamento reservam um valor antecipadamente, que conta para o limite. Quando o limite é atingido, o FlowData recusa novas requisições pagas dessa chave até o mês virar ou você aumentar o limite. Você também pode definir um limite de gastos para toda a equipe, veja Cobrança, saldo e limite de gastos.

Se algo der errado

  • Resposta 401: a chave está faltando, foi copiada incorretamente, expirou ou foi revogada. Verifique se o cabeçalho é exatamente Authorization: Bearer fd_….
  • Resposta 403 com flowdata_access_denied: a chave pertence a alguém que não tem mais acesso ao FlowData na equipe. Uma chave só funciona enquanto o dono puder usar o FlowData.
  • Chave perdida: ninguém consegue exibir o valor novamente. Se você mesmo criou a chave, use Gerar novamente e informe o novo valor na sua integração. Caso contrário, revogue a chave e crie uma nova.

As demais mensagens estão em Erros e limites de requisições.

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API