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.