Passar para o conteúdo principal

Componente Requisição HTTP

Componente Requisição HTTP

Requisição HTTP

Este componente permite realizar uma solicitação HTTP a uma API externa, facilitando a comunicação com outros sistemas.

Propósito e utilidade:

  • Conectar o Atom com plataformas externas mediante requisições HTTP.

  • Enviar e receber dados em tempo real.

  • Integrar com CRMs, bases de dados e outros serviços.

Seção Configuração básica

  • Métodos disponíveis: GET, POST, PUT, DELETE, PATCH e HEAD.

Métodos disponíveis: GET, POST, PUT, DELETE, PATCH e HEAD.

  • URL: Endereço do endpoint ao qual se realiza a requisição.

URL: Endereço do endpoint ao qual se realiza a requisição.

  • Botão de testar requisição: com o método mais a URL carregada, você poderá testar a requisição para verificar se a conexão foi bem-sucedida ou negada. A mesma poderá ser visualizada da seguinte maneira:

Botão de testar requisição: com o método mais a URL carregada, você poderá testar a requisição para verificar se a conexão foi bem-sucedida ou negada. A mesma poderá ser visualizada da seguinte maneira:

Corpo da requisição:

Se este controle for habilitado, você poderá enviar dados diferentes, em formato JSON e XML.

Além disso, com o editor, para maior facilidade, você pode expandir a seção para editar seu código mais facilmente, além de que o mesmo indicará se existem erros, e você poderá copiar ou adicionar os parâmetros que necessitar.

Cabeçalhos:

Ao habilitar esta seção, você pode configurar tipos de cabeçalhos que a requisição requer. Esta seção contém presets prontos para usar (como Authorization, Content-Type ou Accept), com os campos mais comuns pré-configurados. Além disso, os valores confidenciais, como senhas ou tokens, são mostrados ofuscados por segurança e você conta com validações e um contador para que você saiba quantos cabeçalhos foram configurados.

Seção Configurações Avançadas

Autorização:

Habilitando esta seção, você poderá configurar o tipo de autorização que a requisição HTTP requer, como OAuth 2.0 ou Basic Auth.

Salvar Resposta:

Depois de testar a requisição, o JSON aparece pré-carregado e o usuário só deve clicar no campo que deseja salvar. O Atom completará a rota automaticamente e só resta escolher onde salvá-lo (campo de informação ou variável de fluxo). Além disso, continua existindo a opção de salvar toda a resposta.

📌 Exemplo de uso do campo “Salvar resposta”

Suponhamos que estamos realizando uma requisição HTTP para consultar o estado de uma ordem. A API nos devolve uma resposta com a seguinte estrutura:

{ "data": { "estado": "En camino", "fecha_entrega": "2025-06-10" }}

Neste caso, queremos armazenar essa informação para usá-la mais adiante no fluxo. Então, no campo Salvar resposta, configuramos duas variáveis personalizadas:

  • ESTADO_ORDEN

  • DATAENTREGAESTIMADA

E as vinculamos com os dados que provêm da resposta da API:

  • data.estado→ESTADO_ORDEN

  • data.fechaentrega→DATAENTREGA_ESTIMADA

Deste modo, nas etapas seguintes do fluxo podemos utilizar estas variáveis para mostrar mensagens personalizadas como:

“Seu pedido está atualmente em estado: e estimamos que chegue em .”

Gerenciamento de códigos de Resposta:

Agora você pode definir ramos específicos:

  • Êxito (exemplo: códigos 200 ou 201).

  • Erro (códigos 400 ou 500).

  • Tentativa novamente (para erros como 429 ou timeouts), com a possibilidade de configurar até 5 tentativas automáticas antes de continuar o fluxo.

Isto brinda um controle muito mais preciso sobre o que fazer em cada situação.

Tempo de espera API:

Define o tempo máximo em segundos que se esperará para obter uma resposta da API, sendo o máximo 60 segundos.

Respondeu à sua pergunta?