Pular para o conteúdo principal

Usar o Sheet Best no Bubble

O Sheet Best é uma API REST padrão, então um aplicativo do Bubble pode acessá-lo pelo plugin integrado API Connector, sem precisar de um plugin personalizado. Os exemplos mostram as requisições que você configurará como chamadas de API.

Antes de começar​

  • Uma conexão do Sheet Best. Consulte o guia rápido.
  • Um aplicativo do Bubble com o plugin API Connector instalado.
  • Uma chave de API somente se a conexão estiver protegida. Consulte autenticação com chave de API.

Configurar a API no Bubble​

No API Connector, adicione uma nova API para o Sheet Best. Você precisa destes dois dados:

  • URL base: https://api.sheetbest.com/sheets/<id>
  • Cabeçalho compartilhado (opcional): X-Api-Key: <your-key> se a conexão estiver protegida

Todas as chamadas abaixo podem reutilizar essas configurações.

Ler linhas (GET)​

Configure uma chamada com o método GET e a URL da conexão. A resposta é um array JSON de objetos de linha cujas chaves correspondem aos cabeçalhos das colunas. Inicialize a chamada para que o Bubble detecte o esquema da resposta.

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

Por padrão, os valores são retornados como strings. Adicione ?_raw=1 se precisar de tipos JSON nativos; consulte formatos.

Gravar linhas (POST)​

Configure uma chamada com o método POST, a URL da conexão e um corpo JSON. O Sheet Best aceita um objeto ou um array de objetos (uma linha por elemento). Marque cada campo do corpo como parâmetro para vinculá-lo às entradas do Bubble quando a ação for executada.

{
  "Name": "<Name>",
  "Email": "<Email>"
}

Verifique se o tipo de corpo é JSON. Os nomes dos campos devem corresponder aos cabeçalhos das colunas da planilha.

Autenticar​

Para uma conexão protegida, adicione um cabeçalho X-Api-Key, compartilhado por toda a API ou específico de cada chamada:

X-Api-Key: <your-key>

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​