# 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%2F20261015%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20261015T203000Z&X-Amz-Expires=86400&X-Amz-Signature=c68ed3556ecffd2fbceeb5a5de3e15db0c16e8a1e06d6aa81f4c45caf200fbfa&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%2F20261015%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20261015T203000Z&X-Amz-Expires=86400&X-Amz-Signature=58a68020de40523eff9d9bf714e07ec93e4d4da8975c17d74b6c57f5e8a40ceb&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%2F20261015%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20261015T203000Z&X-Amz-Expires=86400&X-Amz-Signature=651e705453d4f07dc90e6a53541cdf97e7d6d4ab7eb0b116ee61a888711285ec&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%2F20261015%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20261015T203000Z&X-Amz-Expires=86400&X-Amz-Signature=321d061ebd6719f33bff0470583df3565d7377e933f83462ab35e040e30cea3d&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%2F20261015%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20261015T203000Z&X-Amz-Expires=86400&X-Amz-Signature=44592a7c45f4c172f40b90a8e0e74122bd1f98a40bbc288288412e3ca5fe054e&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%2F20261015%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20261015T203000Z&X-Amz-Expires=86400&X-Amz-Signature=5be595ad440f9e2884b140e731e14124eb8f24985848a9ff77085cfb53abdd37&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%2F20261015%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20261015T203000Z&X-Amz-Expires=86400&X-Amz-Signature=3e04d455d5e6c62021b90b870af9f62be268bfcffb5ff2040ab7b86971bf0041&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`