Requisição HTTP

Requisição HTTP: Realiza uma requisição para um serviço web externo.

Serve para enviar e receber dados de uma API ou serviço web. Vamos detalhar como configurar este bloco. 

Configuração do Bloco "Requisição HTTP" 


 


ID do Node 

  • Cada bloco no Flowbuilder tem um ID único para identificação. 

  • Exemplo: 2ecb7da7-9400-47fe-bf9d-f8294557925c 

Título do Bloco 

  • Um nome que você dá ao bloco para facilitar a identificação dentro do seu fluxo. 

  • Exemplo: Executar Request HTTP 

Método 

  • Define o tipo de ação que você quer realizar com a requisição. Os mais comuns são: 

  • GET: Para obter dados. 

  • POST: Para enviar dados. 

  • PUT: Para atualizar dados. 

  • DELETE: Para remover dados. 

  • Exemplo: GET 

URL da Requisição 

  • O endereço da internet onde a requisição será enviada. 

  • Exemplo: https://api.convert.app.br/getUsuarios 

  • Informação Importante sobre a Origem da Requisição: As requisições disparadas pela nossa plataforma para a URL que você configurar acima terão origem a partir do seguinte endereço IP: 3.134.11.145.

Timeout da Requisição 

  • O tempo máximo que o bloco vai esperar pela resposta, em segundos. 

Headers 


 


  • Informações extras que vão junto com a requisição, como autenticação. 

  • Como adicionar: 

  • Header: O nome do cabeçalho (como Authorization). 

  • Valor: O valor do cabeçalho (como Bearer eyJhbGciOiJIUzI1NiIs). 

  • Clique em Adicionar para incluir cada cabeçalho. 

Body 


 


  • Dados que você quer enviar no corpo da requisição, usado principalmente em POST ou PUT. 

  • Como adicionar: 

  • Parâmetro: O nome do dado que você quer enviar (como data). 

  • Valor: O valor desse dado (como 2022-10-10). 

  • Clique em Adicionar para incluir cada parâmetro. 

Retorno




  • Aqui você define como os dados retornados pela requisição serão usados no seu fluxo. 

  • Como mapear: 

  • Variável: O nome que você quer dar ao resultado ou parte dele (como status). 

  • Valor: A forma de acessar o dado no resultado (como $.status). 

  • Clique em Adicionar para mapear cada resultado. 

Dicas para Mapear Resultados 

  • Se o resultado da requisição for um objeto, você pode acessar suas propriedades usando a notação de ponto. Por exemplo, se o resultado for { "status": "ok", "data": { "name": "João" } }, você pode acessar o nome com $.data.name. 

  • Se o resultado for uma lista (array), você pode acessar os elementos pelo índice, como $.[0] para o primeiro item. 

Conclusão 

Com essas instruções, você consegue configurar o bloco "Requisição HTTP" no Flow Builder. Lembre-se de que a precisão na configuração é importante para que a requisição funcione corretamente. Se algo não funcionar, revise cada detalhe da configuração. 

Exemplo de uso:

url da api: https://api.nasa.gov/planetary/apod

método: GET

Para usar a api da nasa foi necessário inserir um token de autenticação do tipo x-api-key para que possamos fazer as requisições




Dentro de configurações, configuramos o método e inserimos a URL da requisição. Em retorno, precisamos criar uma variável que irá receber um valor extraído da requisição. Nesse caso, precisamos passar explanation e hdurl para que a variável capture o que foi retornado da API e envie para outro bloco.



Retorno no chat:




Dentro do quadrado vermelho está a variável que recebe o valor $.explanation e dentro do retângulo rosa está a variável que recebe o valor $.hdurl