Corrigir erro ‘API Request Failed’ no Notion em um tipo de propriedade específico

Quando você tenta atualizar ou visualizar uma propriedade de banco de dados no Notion, o erro API Request Failed aparece. Esse erro geralmente atinge um tipo específico de propriedade, como Relação, Rollup, Fórmula ou Seletor. A causa raiz costuma ser uma configuração corrompida, uma relação quebrada entre bancos de dados ou uma fórmula incompatível que faz a API do Notion expirar ou rejeitar a solicitação. Este artigo explica por que o erro ocorre apenas em certos tipos de propriedade e fornece correções passo a passo para resolvê-lo.

Por que o erro API Request Failed atinge tipos específicos de propriedade

O Notion armazena cada propriedade de banco de dados como um objeto separado em seu modelo de dados interno. Quando uma propriedade é corrompida, a chamada de API para ler ou escrever essa propriedade falha. A corrupção pode ocorrer de várias maneiras:

Propriedades de Relação ou Rollup corrompidas

Uma propriedade de Relação vincula dois bancos de dados. Se o banco de dados de destino for excluído, renomeado ou movido para um espaço de trabalho diferente, a relação se quebra. A API do Notion não consegue resolver o link e retorna um erro. Propriedades Rollup herdam dados de uma relação; se a relação estiver quebrada, o rollup também falha.

Propriedades de Fórmula com expressões inválidas

Uma propriedade de Fórmula usa a linguagem de fórmulas do Notion. Se você escrever uma expressão que referencia uma propriedade excluída, usa um nome de função incorreto ou cria uma referência circular, a API não consegue avaliar a fórmula. O erro aparece apenas quando a fórmula é calculada, não quando outras propriedades são carregadas.

Propriedades Seletor e Seletor Múltiplo com opções duplicadas

Se você importar ou sincronizar dados que criam nomes de opções duplicados em uma propriedade Seletor ou Seletor Múltiplo, o Notion pode ficar confuso. A API vê duas opções com o mesmo nome, mas IDs diferentes, e não consegue processar a coluna. Isso é raro, mas acontece ao usar integrações de terceiros como Zapier ou Make.

Passos para corrigir o erro API Request Failed em uma propriedade específica

Antes de começar, faça backup do seu banco de dados. Exporte todo o banco de dados como CSV ou Markdown. Vá ao menu superior direito do banco de dados, selecione Exportar e salve o arquivo no seu computador.

Método 1: Duplicar o banco de dados

1. Abra a página do banco de dados
   Navegue até o banco de dados que mostra o erro. Clique no menu de três pontos no canto superior direito da página.
2. Selecione Duplicar
   No menu, escolha Duplicar. O Notion cria uma cópia de todo o banco de dados no mesmo espaço de trabalho.
3. Teste o banco de dados duplicado
   Abra o banco de dados duplicado e tente visualizar ou editar a propriedade que falhou anteriormente. Se o erro não aparecer mais, o banco de dados original tinha uma configuração de propriedade corrompida. Exclua o banco de dados original e use o duplicado.

Método 2: Excluir e recriar a propriedade problemática

1. Identifique a propriedade com falha
   Percorra as propriedades do banco de dados até encontrar aquela que dispara o erro API Request Failed. Anote o nome e o tipo da propriedade.
2. Exclua a propriedade
   Clique no cabeçalho da propriedade e selecione Excluir propriedade. Confirme a exclusão. Todos os dados nessa coluna são removidos.
3. Recrie a propriedade
   Clique no botão + Adicionar uma propriedade na coluna mais à direita do banco de dados. Selecione o mesmo tipo de propriedade (Texto, Seletor, Relação, etc.). Dê o mesmo nome de antes se quiser manter a consistência.
4. Reinsira os dados se necessário
   Se você excluiu uma propriedade com dados importantes, precisará reinseri-los manualmente ou colá-los do seu backup CSV.

Método 3: Corrigir uma propriedade de Relação quebrada

1. Verifique o banco de dados vinculado
   Clique no cabeçalho da propriedade de Relação. Observe o nome do banco de dados vinculado. Se o nome aparecer em cinza ou mostrar um ícone de link quebrado, o banco de dados de destino está ausente.
2. Restaure ou reconecte o banco de dados vinculado
   Se o banco de dados de destino foi excluído, restaure-o da lixeira do Notion (clique no nome do espaço de trabalho e depois em Lixeira). Se foi movido, mova-o de volta para o local original do espaço de trabalho. Se ainda existir, clique em Editar propriedade e selecione o banco de dados correto na lista.
3. Atualize a propriedade Rollup
   Se o erro estiver em uma propriedade Rollup, após corrigir a Relação, clique no cabeçalho do Rollup, selecione Editar propriedade e selecione novamente a relação e a propriedade a ser rolada. A solicitação de API agora deve funcionar.

Método 4: Simplificar uma propriedade de Fórmula

1. Abra o editor de fórmulas
   Clique no cabeçalho da propriedade de Fórmula e selecione Editar propriedade. O editor de fórmulas aparece.
2. Teste a fórmula em partes
   Copie a fórmula para um editor de texto. Exclua toda a fórmula do Notion e salve. O erro de API deve parar. Em seguida, reconstrua a fórmula pedaço por pedaço, salvando após cada adição. Quando o erro retornar, você encontrou a expressão problemática.
3. Substitua funções problemáticas
   Funções comuns que causam erros incluem prop() referenciando uma propriedade excluída, format() com uma data que não existe ou concat() com uma string muito longa. Substitua ou remova a função ofensora.

Se o Notion ainda mostrar o erro API Request Failed

O erro aparece em todas as propriedades do banco de dados

Se o erro não se limita a uma propriedade, todo o banco de dados pode estar corrompido. Duplique o banco de dados conforme descrito no Método 1. Se a duplicação também falhar, exporte o banco de dados como CSV, crie um novo banco de dados em branco e importe o CSV. Você perde recursos específicos do banco de dados, como Relações e Rollups, mas preserva os dados.

O erro aparece apenas em uma visualização específica

Um filtro ou classificação de visualização quebrada pode disparar o erro. Clique no nome da visualização no topo do banco de dados, selecione Editar visualização e remova todos os filtros e classificações. Se o erro desaparecer, adicione os filtros um a um até encontrar o problemático. Exclua esse filtro e crie um novo.

O erro aparece após uma integração de terceiros sincronizar dados

Integrações como Zapier, Make ou scripts da API do Notion podem introduzir dados malformados. Vá para Configurações e Membros > Conexões e desconecte a integração. Em seguida, corrija manualmente os dados na propriedade afetada. Reconecte a integração somente após o erro ser resolvido.

Tipos de propriedade do Notion e seus pontos de falha comuns comparados

Tipo de Propriedade	Causa Comum de Falha	Melhor Método de Correção
Relação	Banco de dados de destino excluído ou movido	Restaurar destino ou reconectar relação
Rollup	Relação quebrada ou propriedade de origem ausente	Corrigir relação e recriar rollup
Fórmula	Expressão inválida ou referência circular	Simplificar fórmula passo a passo
Seletor / Seletor Múltiplo	Nomes de opções duplicados de importações	Excluir e readicionar opções manualmente
Texto / Número / Data	Raramente causam erros de API sozinhos	Duplicar banco de dados se o erro persistir

A tabela mostra que as propriedades Relação e Rollup são as fontes mais comuns do erro API Request Failed. Propriedades de Fórmula vêm em seguida. Propriedades simples de texto e número raramente causam falhas de API.

Agora você pode identificar qual tipo de propriedade dispara o erro e aplicar a correção correta. Comece duplicando o banco de dados para preservar seus dados. Em seguida, exclua e recrie a propriedade quebrada. Para propriedades de Relação, verifique se o banco de dados vinculado ainda existe. Para propriedades de Fórmula, reconstrua a expressão pedaço por pedaço. Se o erro persistir, desconecte quaisquer integrações de terceiros que sincronizam dados nessa propriedade.