Chaves de API

Uma chave de API permite que um sistema externo (um ERP, um formulário próprio, uma automação) leia e grave dados da sua organização no Bienna², sem usar o login de uma pessoa. É assim, por exemplo, que o formulário de contato do site cria leads. Abra Configurações → Integrações → Chaves de API.

Só para proprietários

Membros não veem esta tela no menu. Chaves de API, Webhooks e Provedores ficam no grupo Integrações.

Plano Business

Chaves de API fazem parte do plano Business (e do Enterprise e do período de teste). No Starter, o botão aparece com um cadeado e a tela mostra o aviso do plano, com o link Ver planos. As chaves que já existem continuam funcionando e podem ser revogadas.

Lista de chaves

A tabela mostra o Nome de cada chave, o início dela (o prefixo bna_…, para você reconhecer qual é qual), o Status e a data em que foi criada. O cartão Como usar resume como um sistema usa a chave e traz um exemplo que pode ser copiado.

Chaves de API

Criar uma chave

1. Clique em Nova chave.
2. Dê um Nome que diga quem vai usá-la, por exemplo "Integração Zapier" ou "Sistema de faturamento".
3. Clique em Criar chave.
4. A tela muda para Chave criada e mostra a chave uma única vez. Copie com o botão ao lado e guarde em local seguro.

A chave só é exibida neste momento

Guarde a chave

O Bienna² não guarda a chave em texto, então não há como vê-la de novo. Se ela se perder, crie uma nova e revogue a antiga.

Crie uma chave para cada sistema. Assim, se um deles vazar a chave ou deixar de ser usado, você revoga só aquela.

Revogar uma chave

Clique em Revogar na linha da chave e confirme. Ela deixa de funcionar na hora e sai da lista: os sistemas que a usam perdem o acesso. Não dá para desfazer.

Para quem vai integrar

Repasse estas informações à equipe técnica:

1. Troque a chave por um token de acesso:

   curl -X POST https://api.bienna2.com/api/auth/api-login \
     -H "Content-Type: application/json" \
     -d '{"apiKey": "bna_..."}'

   A resposta traz token e expiresAt. O token vale por 1 hora; depois, faça o login de novo com a chave.

2. Use o token no cabeçalho Authorization das chamadas:

   curl https://api.bienna2.com/api/leads -H "Authorization: Bearer <token>"

• Recursos disponíveis: leads, clients, contacts e products, com GET, POST, PUT e DELETE.
• Documentação completa: a referência da API fica em https://api.bienna2.com/scalar. O link também aparece no cartão Como usar.
• O que a chave não alcança: chaves não podem criar outras chaves, mexer em webhooks ou alterar a organização. Essas ações são só de proprietários logados no painel.

Checklist

• ✅ Ver a lista de chaves e o cartão Como usar
• ✅ Copiar o exemplo de uso
• ✅ Criar uma chave e copiá-la
• ✅ Revogar uma chave
• ✅ Usar a chave em outro sistema (token e chamadas)
• ✅ Aviso do plano Business no Starter