# 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"  ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/310a3e0d-64df-40ea-8346-67ad18a4e91a/Trv9KeEPAMBBsFvQTyvyd7qhwQ8AANxY1d8kBAAA1IbgBwCAjAl%2BAADImOAHAICMCX4AAMiY4AcAgIwJfgAAyJjgBwCAjAl%2BAADImOAHAICMCX4AAMiY4AcAgIwJfgAAyJjgBwCAjAl%2BAADImOAHAICMCX4AAMiY4AcAgIwJfgAAyJjgBwCAjAl%2BAADImOAHAICMCX4AAMiY4AcAgIwJfgAAyJjgBwCAjAl%2BAADImOAHAICMCX4AAMhWxH8AbnX?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=c05739efbc7300669b6f6e3a4045ef6d52e49a31551dbd3323af9ca2ff008ff8&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =764x542")   **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__**](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**  ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/d01ab60f-9b66-40f7-8f41-cf673673dae4/vQ3EOYEQoCj1ZhCwBwHBNxtLGnQGELAMCnUgq5p1CxoZB%2BADirWL5B3AGAz0Rp5h4AAACAz1lJ7mMHAAAA%2BBIh9wAAAABXIPcAAAAAVyD3AAAAAFcg9wAAAABXIPcAAAAAVyD3AAAAAFcg9wAAAABXIPcAAAAAVyD3AAAAAFcg9wAAAABXIPcAAAAAVyD3AAAAAFcg9wAAAAA36On9Dwuhy7B7CF5LAAAAAElFTkSuQmCC?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=34c21aa5ce6312e42399c6e927db24adad0d637b962fa865fbad0d91d401ee4d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =765x817")  * **I**nformaçõ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**  ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/dc017001-e950-437b-8546-42840a80c907/uECeNHjRymaxtKgIORorLRrkedlvQ0AE2eykCSglQeUo96GgAcVPUSjIRarDcRGXw1AJo4lYGMXOTlqwGAxqC%2BgpFPpeUTj4Amq1IAIg8BaITqPRgBAAAcKgL2cX0AAIBDHcEIAABAIxgBAABoBCMAAACNYAQAAKARjAAAADSCEQAAgEYwAgAA0AhGAAAAGsEIAABAIxgBAABoBCMAAACNYAQAAKARjAAAADSCEQAAgJfJ9P8WB6qNO9WoygAAA?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=06460aa68fbb49c7e27b903da38128f57819555fa46cf0db28d785939e6a05b6&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =776x818")  * 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** ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/a62df782-e4f8-45b0-85ca-16e02bad3c14/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=6a0fd970ed471e054767b79585a58668653a624037227a366323e19e3c5680f9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) * 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 ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/50b92c0b-09e7-444d-a71d-709e5a22de11/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=0fea2ef40a8c24b80a1c02f6193a58cdf998fdd8bff2bd38a1536b6cb4578f6f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 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. ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/86891e8e-796b-4c8e-886f-425a7fdef125/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=404ec081223678fa3ee1c2804cd4b9c1b40ab6455b5649afa51f139e699c2d8a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **Retorno no chat:** ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/77887f00-cc38-494b-ad0b-a691c0b7d423/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=b5ff94e9cef03e68f52c1fec871a5fec5ef1101eb08f55ff539f3975d7826b4b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 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` --- **Documents** - [Manuais de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/manuais-de-produtos-9Zwzl1ufq8) - [Treinamentos em vídeo](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/treinamentos-em-video-RtQVBvFmgW) - [Versões de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/versoes-de-produtos-TH4Y8GFXxO)