Pular para o conteúdo principal

Perguntas frequentes

O que é o Sheet Best?​

O Sheet Best transforma uma planilha do Google Sheets em uma API REST. Cada conexão fornece um endpoint HTTPS para ler, gravar, atualizar e excluir linhas com requisições HTTP padrão.

Como começar?​

Conecte uma planilha do Google Sheets, copie a URL da API e comece a fazer requisições. O passo a passo completo está no guia rápido.

Um assistente de IA pode trabalhar com minhas conexões do Sheet Best?​

Sim. O Sheet Best oferece um servidor MCP remoto que permite a clientes de IA compatíveis listar ou criar conexões, consultar permissões e trabalhar com linhas. O MCP usa um token de portador separado, gerenciado em Configurações → Integrações → Assistentes de IA · MCP. Comece pela visão geral do MCP.

Preciso de uma chave de API?​

As chaves de API são opcionais. Por padrão, qualquer pessoa com a URL pode acessar o endpoint. Para exigir autenticação, ative a chave em Connection → Advanced Settings (Conexão → Configurações avançadas) e envie-a em todas as requisições no cabeçalho X-Api-Key. Consulte chaves de API.

Qual é a diferença entre filtragem e consultas?​

  • A filtragem busca correspondências de texto nos valores das colunas. Você pode filtrar pelo caminho da URL (/Name/John) ou pelo endpoint /search e usar * como curinga.
  • As consultas usam operadores no endpoint /query para comparar números e datas, por exemplo ?Age=__gt(18).

Use filtragem para correspondências de texto e consultas para intervalos e comparações.

Como atualizar ou excluir uma linha?​

Use PATCH (atualização parcial) ou PUT (substituição); consulte atualizar linhas. Use DELETE para remover linhas; consulte excluir linhas. Você pode selecionar linhas por índice ou correspondência de coluna.

As respostas são paginadas?​

O Sheet Best não pagina as respostas automaticamente. Use os parâmetros _limit e _offset para percorrer planilhas grandes. Consulte paginação.

Por que os números são retornados como strings?​

Por padrão, os valores das células são retornados como strings para preservar a formatação. Adicione _raw=1 a qualquer requisição GET para receber tipos nativos (números, booleanos). Consulte formatos de dados.

Posso manter minha planilha privada?​

Sim. Use Connect with Drive (Conectar com o Drive) para autorizar o Sheet Best a acessar uma planilha que não esteja compartilhada com “Qualquer pessoa com o link”. Consulte planilhas privadas.

O que acontece quando esgoto meu plano?​

Quando X-RateLimit-Remaining chega a 0, as requisições retornam 402 Payment Required com o código de erro throttle. Faça upgrade do seu plano para continuar.

Quais são os limites de uso?​

A cota mensal de requisições depende do plano. Consulte X-RateLimit-Limit e X-RateLimit-Remaining em qualquer resposta ou veja a página de preços.

O Sheet Best funciona com várias abas?​

Sim. Adicione o nome da aba à URL: https://api.sheetbest.com/sheets/<id>/tabs/<TabName>. Consulte abas.

Posso chamar o Sheet Best pelo navegador?​

Sim, mas, se você ativou uma chave de API, ela ficará visível para qualquer pessoa que inspecione o tráfego de rede. Para endpoints protegidos, chame a API a partir de um servidor que você controle.