Corrigir erro ‘API Request Failed’ do Notion em 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 frequentemente atinge um tipo específico de propriedade, como Relation, Rollup, Formula ou Select. A causa raiz geralmente é uma configuração corrompida da propriedade, 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 se corrompe, a chamada de API para ler ou escrever essa propriedade falha. A corrupção pode acontecer de várias maneiras:

Propriedades Relation ou Rollup corrompidas

Uma propriedade Relation 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 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 Formula com expressões inválidas

Uma propriedade Formula usa a linguagem de fórmula 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 Select e Multi-Select com opções duplicadas

Se você importar ou sincronizar dados que criam nomes de opções duplicados em uma propriedade Select ou Multi-Select, 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 o banco de dados inteiro como CSV ou Markdown. Vá ao menu no canto 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 do banco de dados inteiro 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 corrompida de propriedade. 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
   Role pelas 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, Select, Relation, etc.). Dê o mesmo nome de antes, se quiser manter 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 em CSV.

Método 3: Corrigir uma propriedade Relation quebrada

1. Verifique o banco de dados vinculado
   Clique no cabeçalho da propriedade Relation. 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 no 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 Relation, clique no cabeçalho do Rollup, selecione Editar propriedade e selecione novamente a relação e a propriedade para fazer o rollup. A solicitação de API deve agora ser bem-sucedida.

Método 4: Simplificar uma propriedade Formula

1. Abra o editor de fórmulas
   Clique no cabeçalho da propriedade Formula 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 peça por peça, salvando após cada adição. Quando o erro voltar, 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 problemática.

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 estiver limitado 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 Relations e Rollups, mas preserva os dados.

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

Um filtro ou classificação de visualização quebrado 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
Relation	Banco de dados de destino excluído ou movido	Restaure o destino ou reconecte a relação
Rollup	Relação quebrada ou propriedade de origem ausente	Corrija a relação e recrie o rollup
Formula	Expressão inválida ou referência circular	Simplifique a fórmula passo a passo
Select / Multi-Select	Nomes de opções duplicados de importações	Exclua e adicione opções manualmente
Texto / Número / Data	Raramente causam erros de API sozinhos	Duplique o banco de dados se o erro persistir

A tabela mostra que as propriedades Relation e Rollup são as fontes mais comuns do erro API Request Failed. Propriedades Formula 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 adequada. Comece duplicando o banco de dados para preservar seus dados. Em seguida, exclua e recrie a propriedade quebrada. Para propriedades Relation, verifique se o banco de dados vinculado ainda existe. Para propriedades Formula, reconstrua a expressão peça por peça. Se o erro persistir, desconecte quaisquer integrações de terceiros que sincronizam dados nessa propriedade.