Chamar uma API externa

Chame uma API REST (Transferência de Estado Representativo) autenticada, trate a resposta e extraia dados para nós de fluxo de trabalho subsequentes.

O que você criará: um fluxo de trabalho que chama uma API REST (Transferência de Estado Representativo) autenticada, lida com a resposta e disponibiliza os dados extraídos para nós subsequentes. Esse é um dos padrões mais comuns no Fluxo — ele se aplica a qualquer sistema que expõe um ponto de extremidade HTTP.

O que você precisa

• Uma conta do UiPath Automation Cloud com acesso ao Fluxo do Maestro.
• O URL base da API de destino, o caminho do ponto de extremidade e os detalhes de autenticação (chave de API, token de portador ou credenciais de autenticação básicas).

Nós usados

• Gatilho manual — inicia o fluxo de trabalho sob demanda
• Solicitação HTTP — chama a API REST
• Transformação de dados — extrai os campos necessários da resposta
• Script — registra falhas no caminho de erro da Solicitação HTTP

Etapas

1. Crie um novo fluxo e adicione um gatilho

1. Abra o Maestro → Fluxo e crie um novo fluxo de trabalho.
2. Arraste um Disparo manual para a tela.

2. Adicione e configure o nó de Solicitação HTTP

1. Arraste um nó de Solicitação HTTP para a tela e conecte-o ao gatilho.
2. No painel de configuração:
   • Defina Método como o verbo apropriado (GET, POST, PUT, PATCH ou DELETE).
   • Insira o URL completo do ponto de extremidade.
   • Em Cabeçalhos, adicione cabeçalhos de autenticação e de tipo de conteúdo.

Para autenticação de chave de API:

Adicione um cabeçalho com chave Authorization e valor Bearer {{ secret.apiKey }}. O prefixo secret. informa o Fluxo para procurar o valor em seu armazenamento seguro de variável — nunca cole a chave diretamente no campo.

Para autenticação básica:

Adicione um cabeçalho com chave Authorization e valor Basic {{ secret.encodedCredentials }}, onde encodedCredentials é a string codificada em username:password base64.

3. Extraia os dados de que você precisa

1. Arraste um nó de Transformação de dados para a tela e conecte-o ao nó de Solicitação HTTP.
2. No painel de configuração, mapeie os campos de resposta que você precisa de $vars.httpRequest1.output.body para variáveis de saída nomeadas.

Por exemplo, para extrair o nome e o e-mail de um usuário a partir de uma resposta como { "user": { "name": "Alex", "email": "[e-mail]" } }, mapeie:

• $vars.httpRequest1.output.body.user.name → userName
• $vars.httpRequest1.output.body.user.email → userEmail

4. Adicione tratamento de erros

1. Selecione o nó de Solicitação HTTP.
2. Arraste de seu identificador de erro (o conector inferior direito) para um novo nó de Script.
3. No nó do Script, registre o erro de $vars.httpRequest1.error:

const error = $vars.httpRequest1.error;
console.log('API call failed:', error.message, '| Status:', error.status);
return null;

5. Teste e Debug

Selecione Teste. No trace de execução:

• Verifique a saída statusCode do nó de Solicitação HTTP. 200 significa sucesso; 401 significa que sua autenticação está errada; 404 significa que o URL está incorreto.
• Verifique a saída em nó de Transformação de dados para confirmar que os campos foram extraídos corretamente.
• Para testar o caminho do erro, defina temporariamente o URL para um valor inválido e verifique a execução do caminho do erro.

Resultado

Seu fluxo de trabalho chama a API REST, extrai os campos necessários da resposta e registra falhas no caminho do erro. Você pode inspecionar o código de status HTTP e os valores extraídos no Trace de execução e confirmar que os caminhos de sucesso e erro funcionam conforme o esperado.

Estender este fluxo de trabalho

• Identificar paginação: se a API retornar Resultados em várias páginas, adicione nós de Solicitação HTTP de acompanhamento para buscar páginas adicionais, ramificando-se com uma decisão sobre se a resposta inclui um cursor de próxima página.
• Gravar resultados para outro sistema: após o nó Transformação de dados, adicione outro nó de Solicitação HTTP ou um nó de integração para enviar os dados para jusante.
• Agendar: substitua o disparo manual por um disparo agendado para executar o fluxo de trabalho em um intervalo regular.