Pular para o conteúdo principal

Usar o Sheet Best no n8n

O Sheet Best é uma API REST padrão, então qualquer fluxo do n8n pode acessá-lo pelo nó integrado HTTP Request, sem nós personalizados nem pacotes da comunidade. Os exemplos mostram requisições comuns; você decide como conectá-las ao seu fluxo.

Antes de começar​

  • Uma conexão do Sheet Best. Veja como criá-la no guia rápido.
  • A URL da conexão, no formato https://api.sheetbest.com/sheets/<id>.
  • Uma chave de API somente se a conexão estiver protegida. Consulte autenticação com chave de API.

Ler linhas (GET)​

Configure um nó HTTP Request com o método GET e a URL da conexão. A resposta é um array de objetos de linha cujas chaves correspondem aos cabeçalhos das colunas.

GET https://api.sheetbest.com/sheets/<id>

Por padrão, os valores são retornados como strings. Adicione ?_raw=1 para obter tipos JSON nativos. Consulte formatos.

Gravar linhas (POST)​

Selecione o método POST, defina a URL da conexão e envie um corpo JSON. O Sheet Best aceita um objeto ou um array de objetos (uma linha por elemento).

[
  { "Name": "Jane", "Email": "[email protected]" },
  { "Name": "John", "Email": "[email protected]" }
]

Verifique se o nó envia o corpo como JSON (Content-Type: application/json). Os nomes das colunas no corpo devem corresponder aos cabeçalhos da planilha.

Autenticar​

Se a conexão exigir uma chave, adicione um cabeçalho X-Api-Key ao nó HTTP Request:

X-Api-Key: <your-key>

Você pode armazenar a chave nas credenciais do n8n ou em variáveis de ambiente e referenciá-la no campo de cabeçalho. Consulte autenticação com chave de API.

Atualizar e excluir linhas​

O mesmo padrão se aplica a outros métodos:

Para selecionar uma linha específica, inclua uma correspondência de coluna na URL, por exemplo PATCH /sheets/<id>/Email/[email protected].

Próximos passos​