Ao ver o erro ‘API Token Revoked’ no Notion, sua integração ou chave de API não consegue mais autenticar com o servidor. Esse erro geralmente aparece após regenerar um segredo de integração interna, excluir uma integração do workspace ou quando as políticas de segurança do Notion expiram tokens antigos automaticamente. Este artigo explica por que o token é revogado e fornece instruções passo a passo para criar ou reconectar um token de integração funcional.
Principais conclusões: Corrigindo o erro de token de API revogado do Notion
- Minhas integrações > Integração interna > Segredos > Mostrar > Copiar: Gere um novo token após o antigo ser revogado.
- Integração > Capacidades > Ler conteúdo / Atualizar conteúdo: Certifique-se de que a integração tenha as permissões corretas antes de conectar a um banco de dados.
- Conexão do banco de dados > Adicionar conexões > Selecionar integração: Reconecte um banco de dados a um token de integração novo ou regenerado.
Por que o Notion revoga um token de API
Um token de API é uma string secreta que identifica sua integração para a API do Notion. O Notion revoga um token por três motivos principais:
Primeiro, você ou outro administrador do workspace regenerou manualmente o token nas configurações de integração. A regeneração invalida imediatamente o token antigo. Segundo, a própria integração foi excluída do workspace. Excluir uma integração remove todos os tokens associados. Terceiro, o Notion pode expirar automaticamente tokens que não são usados por um longo período, embora isso seja menos comum. Uma vez revogado, qualquer chamada de API usando o token antigo retorna uma resposta HTTP 401 Não Autorizado com a mensagem de erro ‘API token revoked’.
Passos para resolver o erro de token de API revogado
- Abra as configurações de integração do Notion
Vá para Configurações e Membros na barra lateral esquerda. Em seguida, clique em Minhas conexões na seção Workspace. Role para baixo e clique em Gerenciar integrações para abrir a página de Integrações. - Localize sua integração
Na página de Integrações, encontre a integração que usava o token revogado. Clique no nome dela para abrir a página de configurações da integração. - Gere um novo token
Nas configurações da integração, role até a seção Segredos. Clique em Mostrar ao lado do token existente e depois em Regenerar. Uma nova string de token aparece. Clique em Copiar e salve-a com segurança. O token antigo agora está revogado e não pode mais ser usado. - Atualize seu aplicativo ou script
Substitua o token antigo no código do seu aplicativo, variável de ambiente ou arquivo de configuração pelo novo token. Se você usa uma ferramenta de terceiros que se conecta via API, insira o novo token no painel de configurações dela. - Reconecte a integração aos bancos de dados
Se a integração estava conectada anteriormente a bancos de dados específicos, você precisa reconectá-la. Abra qualquer banco de dados que a integração deve acessar. Clique no menu de três pontos no canto superior direito da visualização do banco de dados. Selecione Adicionar conexões no menu. Encontre sua integração na lista e clique em Confirmar. Repita para cada banco de dados que a integração precisa ler ou escrever. - Teste a conexão
Execute uma chamada de API simples, como recuperar uma lista de bancos de dados, para confirmar que o novo token funciona. A chamada deve retornar um status 200 OK em vez de um erro 401. Se o erro persistir, verifique se a integração tem as capacidades corretas definidas na página de configurações da integração, em Capacidades.
Se o Notion ainda mostrar o erro revogado após a correção principal
Integração foi excluída do workspace
Se você não encontrar sua integração na página Minhas integrações, um administrador pode tê-la excluído. Para corrigir, crie uma nova integração. Vá para Configurações e Membros > Minhas conexões > Gerenciar integrações > Nova integração. Dê um nome à integração, selecione o workspace e defina as capacidades apropriadas. Copie o novo token e siga os passos 4 a 6 acima para reconectar os bancos de dados.
Token não copiado corretamente
Um erro comum é copiar apenas parte da string do token ou incluir um espaço extra no início ou no final. O token é uma longa string alfanumérica que começa com secret_. Verifique novamente o conteúdo da sua área de transferência e certifique-se de que o token foi colado exatamente como mostrado nas configurações de integração.
Integração não aparece na lista de conexões do banco de dados
Ao clicar em Adicionar conexões em um banco de dados, apenas integrações que receberam acesso a esse banco de dados aparecem. Se sua integração estiver faltando, você deve primeiro conectá-la a partir das configurações do banco de dados. Alternativamente, abra as configurações da integração e verifique se ela tem as capacidades Ler conteúdo e Atualizar conteúdo habilitadas. Sem elas, a integração não pode ser adicionada a nenhum banco de dados.
Token de API do Notion revogado vs expirado vs inválido: diferenças
| Item | Token Revogado | Token Expirado | Token Inválido |
|---|---|---|---|
| Descrição | Token invalidado manualmente ou integração excluída | Token além do período de validade | Token nunca existiu ou estava malformado |
| Código de status HTTP | 401 Não Autorizado | 401 Não Autorizado | 401 Não Autorizado |
| Mensagem de erro | API token revoked | API token expired | API token invalid |
| Causa comum | Segredo regenerado ou integração excluída | Token com mais de 90 dias (raro) | Erro de digitação no token ou token errado colado |
| Solução | Regenerar token e reconectar | Regenerar token | Copiar o token correto |
Agora você pode resolver o erro ‘API Token Revoked’ regenerando o token e reconectando sua integração a cada banco de dados. Após concluir as etapas, teste a conexão com uma chamada de API simples para confirmar a correção. Como dica avançada, armazene seu token de API do Notion em uma variável de ambiente em vez de codificá-lo diretamente no script para simplificar futuras rotações de token.