Skip to main content
Já usa uma chave de API de conta?Os tokens de acesso pessoal estão substituindo as chaves de API de conta e, a partir de 15 de outubro de 2026, você não poderá mais usar uma chave de API de conta. A migração é rápida: crie um token e depois altere uma linha em qualquer lugar que use a chave antiga. Veja migrando de chaves de API de conta.
Às vezes, você quer que algo fora da Base44 trabalhe com o seu app: um script que adiciona os pedidos desta manhã, uma ferramenta de automação como Zapier ou Make, ou um assistente de IA que lê seus dados. Um token de acesso pessoal é como você permite a entrada. Pense nele como uma chave que representa você. Qualquer coisa que possua o token pode fazer o que você pode fazer, e nada além disso, portanto um token não pode alcançar um app ao qual você não tem acesso. Isso também significa que você deve tratá-lo como uma senha: nunca cole em um lugar público, um documento compartilhado ou no próprio código do seu app. Cada token pertence a um workspace, então crie-o no workspace cujos apps você quer alcançar. Vale a pena criar um token separado para cada ferramenta que você conectar: quando uma delas precisar ser desconectada, as demais continuam funcionando, e o nome na sua lista indica o que você está desconectando. Duas coisas vale a pena saber antes de depender de um token. Um token para de funcionar se você sair do workspace, e seu admin do workspace pode ver que ele existe e desativá-lo, embora nunca veja seu valor. Um token pertence a você pessoalmente, então serve para seus próprios scripts e ferramentas. Se toda a sua equipe depende de uma integração, use uma chave de API de workspace, para que ela continue funcionando quando pessoas entram e saem. Veja gerenciando segredos do workspace.
Uma captura de tela da aba Personal access tokens em Secrets, listando um token em ambas as tabelas

Seus próprios tokens de acesso e todos os tokens de membros no workspace

​
Criando um token de acesso

Você decide o que cada token pode fazer no momento em que o cria, e a Base44 mostra o valor uma vez.
Copie seu token de acesso assim que criá-lo e armazene em algum lugar seguro. A Base44 nunca mostra o valor novamente, então se você o perder, terá que criar um novo token.
Uma captura de tela da caixa de diálogo Create a personal access token, mostrando as escolhas de nome, acesso e permissão

Escolhendo o que um novo token de acesso pode alcançar e o que pode fazer

Para criar um token de acesso pessoal:
  1. No seu workspace, clique no nome do workspace no canto inferior esquerdo e depois em Settings.
  2. Clique em Secrets na barra lateral.
  3. Clique na aba Personal access tokens.
  4. Clique em Create access token.
  5. Digite um Access token name que diga para que o token serve, como a ferramenta que você está conectando.
  6. Em Access, escolha o que o token pode alcançar:
    • All apps and Superagents: Tudo no workspace que você pode alcançar.
    • One app or Superagent: Procure pelo app ou Superagent desejado e selecione-o.
  7. Em Permission, escolha o que o token pode fazer:
    • Full access: Ler e alterar dados, executar funções e editar apps.
    • Read-only: Ler, pesquisar e exportar dados. Nada pode ser alterado.
  8. Clique em Create access token.
  9. Clique no ícone Copy ao lado do valor, cole o token na ferramenta que está conectando e clique em Done.
Uma captura de tela da tela Copy your access token, com o ícone de copiar ao lado do valor do token

Copiando um novo token de acesso, que a Base44 mostra apenas uma vez

​
Usando seu token em uma requisição

O que você conectar precisa enviar seu token com cada requisição, para que a Base44 saiba que a requisição vem de você. Ele vai em uma linha chamada cabeçalho, e fica assim:
A maioria das ferramentas tem um campo para isso, geralmente rotulado Authorization, Bearer token ou API token. Se você mesmo estiver escrevendo a requisição, uma completa se parece com isso:
Substitua YOUR_PERSONAL_ACCESS_TOKEN pelo seu próprio token, ou a requisição falha. Você não precisa digitar nada disso do zero: abra a referência de API do seu app no editor do app e ela mostra a mesma requisição com seus tokens listados, pronta para copiar.
As chaves de API de conta usavam um cabeçalho diferente, api_key: YOUR_API_KEY. Se você está atualizando algo que já funciona, troque a linha inteira, não apenas o valor. Um token enviado sob o cabeçalho antigo é rejeitado.

​
Migrando de chaves de API de conta

A Base44 está substituindo as chaves de API de conta por tokens de acesso pessoal, então todos que usam uma precisam migrar. Se você já copiou uma chave de API das configurações da sua conta, essa chave é uma chave de API de conta, e a partir de 15 de outubro de 2026, você não pode mais usar uma. Um token de acesso pessoal faz o mesmo trabalho, e 2 coisas mudam quando você troca:
  • De onde vem a credencial: Em vez de uma chave que alcançava tudo o que você podia alcançar, você cria um token em Secrets e escolhe o que ele pode tocar.
  • O cabeçalho pelo qual viaja: Authorization: Bearer substitui api_key. Atualize tanto o cabeçalho quanto o valor, porque um token enviado sob o cabeçalho antigo é rejeitado.
Lado a lado, a linha de cabeçalho muda assim:
Para migrar um script para um token de acesso pessoal:
  1. No seu workspace, clique no nome do workspace no canto inferior esquerdo e depois em Settings.
  2. Clique em Secrets na barra lateral e depois na aba Personal access tokens.
  3. Clique em Create access token e dê ao token apenas o acesso e a permissão que o script realmente precisa.
  4. Clique no ícone Copy ao lado do valor e clique em Done. A Base44 nunca mostra o valor novamente.
  5. Substitua a chave no seu script pelo valor do token.
  6. Altere o cabeçalho da requisição de api_key: YOUR_API_KEY para Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN.
  7. Execute o script para confirmar que funciona e exclua a chave de API de conta antiga.
Enquanto estiver lá, dê ao token menos poder do que a chave antiga tinha. Se um script apenas lê dados, torne-o Read-only, e se ele toca em apenas um app, aponte-o para esse app. Assim, um token vazado não pode ser usado para alterar nada.

​
Gerenciando um token

Seus tokens são listados em My personal access tokens, com o que cada um pode alcançar, o que pode fazer, quando foi usado pela última vez e se está ativado. Se a lista ficar longa, clique em Filter para restringi-la por permissão, último uso ou status. Desativar é a escolha segura quando algo parece errado, porque tudo o que usa aquele token para de uma vez e você pode reativá-lo depois. Excluir é permanente, então reserve para uma ferramenta com a qual você terminou. A exceção é um token que foi exposto, em uma captura de tela, um arquivo compartilhado ou um repositório público: exclua esse, em vez de desativá-lo, e depois crie um substituto, porque excluir torna o valor antigo inútil imediatamente. Para gerenciar um token:
  1. No seu workspace, clique no nome do workspace no canto inferior esquerdo e depois em Settings.
  2. Clique em Secrets na barra lateral e depois na aba Personal access tokens.
  3. Ao lado do token que deseja alterar, clique no ícone More actions .
Uma captura de tela do menu More actions de um token aberto, mostrando Edit, Disable e Delete

Editando, desativando ou excluindo um token no menu More actions

Em seguida, escolha o que quer fazer:
Clique em Edit, atualize o nome, acesso ou permissão, e clique em Save. O valor do token em si nunca muda, então o que estiver usando continua funcionando.
Clique em Disable e depois em Disable novamente para confirmar. Qualquer coisa que use o token para de funcionar até você reativá-lo, e o token aparece como Disabled na sua lista.
Um token desativado oferece Enable no mesmo menu. Se seu workspace apertou a política desde que você criou o token, você não pode reativá-lo até que o token atenda à política novamente.
Clique em Delete e depois em Delete novamente para confirmar. Qualquer coisa que use o token para de funcionar imediatamente, e isso não pode ser desfeito.

​
Se seu workspace limita tokens

Alguns workspaces decidem se tokens podem ser usados e o quanto um token pode fazer. Se você é admin do workspace, veja gerenciando segredos do workspace para definir essa política. Como membro, você encontrará isso de uma destas formas:
  • Personal access tokens are blocked in this workspace: Nenhum token de membro pode alcançar os apps ou dados do workspace. Tokens existentes ficam suspensos até que um admin os reative.
  • Doesn’t meet policy: O token foi permitido quando você o criou, mas a política mudou desde então. Ele continua funcionando até que alguém o desative, e a dica de ferramenta diz qual parte da política ele não atende.
  • Not allowed by workspace policy: Uma opção de permissão ou acesso que você não pode escolher, porque a política não permite.
Se um token que você precisa está bloqueado, ou uma opção que você quer está esmaecida, pergunte ao admin do workspace sobre a política. Ele pode afrouxá-la ou reativar um token específico para você.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.