Resumo: Neste artigo, você aprenderá como utilizar o nó HTTP Request no N8N para enviar e consumir dados de APIs de diversos serviços online. Exploraremos exemplos práticos, como consumir dados de uma API de CEP e buscar endereços específicos, além de abordar propriedades importantes como autenticação e envio de parâmetros.
Introdução
O N8N é uma plataforma de automação de código aberto que permite integrar diferentes serviços e automatizar tarefas sem a necessidade de programação avançada. Um dos nós mais utilizados no N8N é o HTTP Request, responsável por enviar requisições HTTP para APIs e receber dados de diversos serviços online.
Neste guia, vamos:
- Entender o que é o nó HTTP Request e suas principais funcionalidades.
- Aprender a configurar requisições GET e POST.
- Explorar exemplos práticos de consumo de APIs.
- Conhecer propriedades adicionais como autenticação e envio de parâmetros.
O que é o Nó HTTP Request no N8N?
O nó HTTP Request permite que você envie requisições HTTP para qualquer API disponível na internet. Com ele, você pode:
- Enviar dados para uma API (requisições POST, PUT, DELETE).
- Obter dados de uma API (requisições GET).
- Integrar o N8N com serviços que não possuem um nó específico.
Principais Métodos HTTP
- GET: Recupera informações de um servidor.
- POST: Envia dados para um servidor para criar ou atualizar um recurso.
- PUT: Atualiza um recurso existente.
- DELETE: Remove um recurso.
Exemplo Prático 1: Consumindo Dados de uma API de CEP
Vamos começar com um exemplo simples: consumir dados de uma API que retorna informações de um CEP (Código de Endereçamento Postal).
Passo a Passo
- Adicionar o Gatilho Manual
- No N8N, inicie um novo fluxo e adicione o nó Manual Trigger para facilitar os testes.
- Adicionar o Nó HTTP Request
- Pesquise por HTTP Request e adicione o nó ao fluxo.
- Configurar a Requisição GET
- No campo Method, selecione GET.
- No campo URL, insira o endereço da API que fornece dados de CEP. Por exemplo:bashCopiar código
https://viacep.com.br/ws/01001000/json/Substitua “01001000” pelo CEP desejado.
- Executar o Teste
- Clique em Execute Node para testar a requisição.
- Os dados do CEP serão exibidos, incluindo rua, bairro, cidade e estado.
Análise do Resultado
- Resposta da API: Você receberá um objeto JSON com as informações do CEP.
- Utilização dos Dados: Os dados podem ser utilizados em nós subsequentes para automatizar tarefas, como preencher formulários ou enviar mensagens.
Exemplo Prático 2: Buscando Endereços Específicos
Agora, vamos utilizar outra API para buscar todos os endereços de Porto Alegre que contêm a palavra “Domingos”.
Passo a Passo
- Obter o Link da API
- Utilize uma API que permita pesquisar endereços por cidade e palavra-chave.
- Exemplo de URL:arduinoCopiar código
https://api.exemplo.com/enderecos?cidade=Porto+Alegre&busca=Domingos
- Adicionar um Novo Nó HTTP Request
- Adicione outro nó HTTP Request ao fluxo.
- Configurar a Requisição
- Método: GET
- URL: Cole o link da API obtido.
- Executar o Teste
- Clique em Execute Node.
- A API retornará uma lista de endereços que correspondem à busca.
Utilização dos Resultados
- Processamento dos Dados: Com os endereços em mãos, você pode dar sequência ao fluxo, como enviar notificações, atualizar bancos de dados ou gerar relatórios.
Propriedades Adicionais do Nó HTTP Request
O nó HTTP Request possui diversas propriedades que permitem configurar requisições mais complexas.
Autenticação
- Tipos de Autenticação: Suporta Basic Auth, OAuth, API Key, entre outros.
- Configuração: Na aba Authentication, selecione o tipo de autenticação exigido pela API e preencha as credenciais necessárias.
Envio de Parâmetros
- Query Parameters: Parâmetros enviados na URL após o símbolo
?. Podem ser adicionados no campo Query Parameters. - Headers: Cabeçalhos HTTP que podem ser adicionados no campo Headers.
- Body: Para métodos como POST, PUT ou DELETE, você pode enviar dados no corpo da requisição, seja em formato JSON, XML ou Form Data.
Exemplo de Envio de Parâmetros
- Passando Parâmetros Campo a Campo:
- Adicione cada parâmetro individualmente nos campos apropriados.
- Enviando um Arquivo JSON:
- No campo Body, selecione o tipo JSON e insira o conteúdo.
Dicas Importantes
- Utilize Variáveis: Você pode utilizar dados de nós anteriores para preencher URLs, parâmetros e cabeçalhos.
- Tratamento de Erros: Implemente mecanismos para lidar com erros na requisição, como nós de validação e condicionais.
- Explorar Documentação: Sempre consulte a documentação da API que está consumindo para entender os requisitos e limitações.
Conclusão
O nó HTTP Request é uma ferramenta essencial no N8N, permitindo integrar praticamente qualquer serviço online ao seu fluxo de trabalho. Seja para obter dados de uma API pública ou para interagir com serviços internos, o HTTP Request oferece a flexibilidade necessária para expandir as capacidades de automação do N8N.
Aproveite as dicas e exemplos deste artigo para explorar novas integrações e otimizar seus processos.
FAQ
1. O que é o nó HTTP Request no N8N?
O nó HTTP Request permite enviar requisições HTTP para APIs e serviços online, possibilitando a integração do N8N com uma ampla variedade de sistemas, mesmo aqueles que não possuem nós específicos na plataforma.
2. Quais métodos HTTP posso utilizar no nó HTTP Request?
Você pode utilizar os principais métodos HTTP, incluindo GET, POST, PUT, DELETE, PATCH, entre outros.
3. Como adiciono autenticação às minhas requisições?
Na configuração do nó HTTP Request, há uma seção de Authentication onde você pode selecionar o tipo de autenticação exigido pela API (como Basic Auth, OAuth2, API Key) e fornecer as credenciais necessárias.
4. Posso enviar dados no corpo da requisição?
Sim. Para métodos como POST ou PUT, você pode enviar dados no corpo da requisição, escolhendo o formato apropriado (JSON, XML, Form Data) na configuração do nó.
5. O que fazer se a API que quero usar não tem um nó específico no N8N?
Você pode utilizar o nó HTTP Request para interagir com qualquer API RESTful, mesmo que não haja um nó específico no N8N para essa integração. Basta configurar a requisição conforme a documentação da API.
