API Keys

Nível de acesso requerido

Admin ou Super Admin

Para que servem as API Keys?

API Keys permitem que sistemas externos acessem a API do Flowi Agentic de forma programática, sem login de usuário. São usadas para:

• Integrações com ERPs, sistemas fiscais, portais
• Automações externas que precisam iniciar processos ou consultar dados
• Scripts e ferramentas de linha de comando

Criando uma API Key

1. Acesse Integração → API Keys
2. Clique em Nova API Key
3. Informe um nome descritivo (ex.: "Integração ERP SAP")
4. Clique em Gerar

A chave gerada é exibida apenas uma vez. Copie e guarde em local seguro antes de fechar a janela.

Segurança

• Nunca compartilhe a API Key em repositórios de código ou ambientes não seguros
• Cada integração deve usar sua própria chave separada
• Rotacione as chaves periodicamente

Usando a API Key

Inclua a chave no header de cada requisição:

X-API-Key: sua-chave-aqui

A chave identifica o tenant automaticamente — não é necessário informar o X-Tenant-ID separadamente quando a autenticação é por API Key.

Revogando uma API Key

Clique em Revogar na linha da chave. A revogação é imediata — qualquer sistema usando aquela chave perderá o acesso instantaneamente.

Boas práticas

Tenha uma política de rotação periódica das chaves. Ao rotacionar, crie a nova chave, atualize o sistema externo e só então revogue a chave antiga.