Pular para o conteúdo principal

Requisições HTTP (Busca HTTP)

O componente Busca HTTP traz dados de uma API e mostra o resultado como uma tabela na página. É o "primo" do Banco de dados: mesma ideia, mas os dados vêm de uma API em vez de um banco.

Duas coisas diferentes com nomes parecidos

Não confunda:

  • Busca HTTP (esta página) — um componente que traz dados de uma API para exibir numa tabela.
  • Requisição HTTP — uma ação de botão que chama uma API (por exemplo, para enviar dados). Essa fica em Automações.

Passo a passo​

Com o componente Busca HTTP selecionado, na aba Config:

  1. Método — GET ou POST.
  2. URL — o endereço da API.
  3. Caminho dos dados — quando a API devolve um JSON, indica qual campo contém a lista de itens a exibir. Ex.: se a resposta é { "resultados": [ ... ] }, o caminho é resultados.
  4. Cabeçalhos e Parâmetros de query — pares de chave/valor (por exemplo, um cabeçalho Authorization para autenticar na API).
  5. Salvar a integração.
  6. Testar — roda a requisição, mostra a resposta e deixa você marcar quais colunas exibir.

Sempre use o "Testar"​

O botão Testar é o seu melhor amigo aqui: ele mostra a resposta real da API e lista as colunas encontradas. Marque as que quer na tabela. Use-o para confirmar a URL, o caminho dos dados e as colunas antes de publicar — é onde erros de endereço, de autenticação ou de caminho aparecem.

O "caminho dos dados" é o erro nº 1

Se a tabela aparece vazia mesmo com a API respondendo, quase sempre o caminho dos dados está errado — ele precisa apontar para o campo que contém a lista. Confira a resposta no Testar e ajuste.

Usando valores dos campos​

Assim como no banco de dados, você pode passar valores dos campos para a requisição (na URL ou nos parâmetros), referenciando o campo com $Campo — o mesmo formato do Banco de dados.

Vale a mesma regra do "carrega uma vez"

A busca roda uma única vez, quando a página abre. Um campo da mesma página ainda estará vazio nesse momento. Para alimentar a requisição, use um $args (parâmetro da URL) ou um valor vindo de uma página anterior. Detalhes em Expressões e variáveis.

Exibindo e usando os resultados​

Igual ao componente de banco de dados, os resultados aparecem como uma tabela, e você pode:

  • Selecionável — deixar o usuário clicar para selecionar linhas (com um número máximo de seleções).
  • Editável — deixar o usuário editar as células.

O que o usuário seleciona vira o "valor" do componente, reaproveitável por expressão:

{{ $form.Busca_HTTP.nome }}